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效 字 有 版权 声明 


图 灵 社 区 的 电子 书 没有 采用 专 有 客 
户 端 ， 您 可 以 在 任意 设备 上 ， 用 自 
己 喜 欢 的 浏览 器 和 PDF 阅读 器 进行 
阅读 。 

但 您 购买 的 电子 书 仅 供 您 个 人 使 用 ， 
未 经 授权 ， 不 得 进行 传播 。 

我 们 愿意 相信 读者 具有 这 样 的 良知 
和 觉悟 ， 与 我 们 共同 保护 知识 产权 。 


如 果 购 买 者 有 侵权 行为 ， 我 们 可 能 
对 该 用 户 实 施 包括 但 不 限于 关闭 该 
帐号 等 维权 措施 ， 并 可 能 追究 法 律 
责任 。 


作者 简介 
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Stephan Hochhaus 
资深 Web 开 发 人 员 ， 在 可 扩展 的 Web 
解决 方案 方面 具有 丰富 的 经 验 。 精 通 
JavaScript、PHP、C# 和 Java。 


Manuel Schoebel 
资深 Web 开 发 人 员 ， 其 技术 博客 广 受 开 
发 者 欢迎 。 


两 人 均 是 从 Meteor 诞 生 之 初 就 一 直 在 工 
作 上 运用 Meteor。 
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杨 学 辉 

自由 程序 员 , 译 者 ,独立 博客 昔 数 博 
客 一 一 的 博 主 。 数 学 系 毕业 的 技术 爱好 
者 ,兴趣 广泛 ,致力 于 学 习 和 开发 新 的 技 
术 ， 以便 高 效 解 决 现实 生活 中 的 实际 问 
题 。 深入 的 了 解 和 交流 ,可 以 访问 他 的 博 
客 : http:/www.bagualu.net。 
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内 容 提 要 


本 书 秉承 “实战 ”系列 图 书 的 一 贯 风 格 ， 以 解决 开发 者 实际 问题 为 出 发 点 ， 通 过 Meteor 平台 构建 可 扩 
展 的 高 性 能 应 用 。 全 书 共 分 为 三 部 分 、12 章 ， 详 细 介 绍 了 如 何 用 Meteor 进行 全 栈 开发 ， 涵 盖 了 Meteor 栈 的 
所 有 关键 部 分 ， 涉 及 构成 Meteor 栈 的 各 种 组 件 和 概念 、 响 应 式 应 用 的 基本 模块 和 应 用 的 构建 与 合理 部 署 等 。 
作者 对 MongoDB、 路 由 、 包 等 进行 了 深入 探讨 ， 通 过 诸多 实际 案例 ， 让 读者 全 面 掌握 如 何 充 分 发 挥 Meteor 
在 服务 器 端 和 可 扩展 性 上 的 优势 。 

本 书 适合 Web 开发 人 员 阅 读 。 
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2011 年 , 我 和 Geoff Schmidt、Nick Martin 一 起 开始 开发 Meteor( 流星 ), 这 是 一 个 新 的 JavaScript 
应 用 平台 。 我 们 的 计划 是 使 JavaScript 开 发 者 能 够 在 清晰 的 概念 之 上 有 条 不 率 地 创建 优秀 的 Web 
和 移动 应 用 。 

JavaScript 是 一 种 非凡 的 技术 。 它 最 初 是 作为 浏览 器 的 脚本 工具 , 现在 已 经 成 为 一 种 无 处 不 在 
的 编程 语言 ， 比 如 在 浏览 器 、 移 动 设 备 以 及 云 中 。 它 得 到 了 专家 和 初学 者 的 青睐 ， 而 这 是 软件 行 
业 一 个 不 寻常 的 组 合 。 但 JavaScript 的 生态 系统 是 高 度 分 散 的 ， 那 些 选 择 JavaScript 的 团队 必须 从 
无 到 有 地 构建 和 维护 整个 应 用 栈 , 需要 在 一 些 低级 的 技术 任务 上 花费 大 量 的 时 间 ， 比 如 设计 应 用 
特定 的 WebSocket 消 息 ， 而 这 些 工 作 和 他 们 实际 的 应 用 根本 没有 什么 关系 。 

Meteor 为 那些 希望 创建 现代 化 应 用 的 JavaScript 开 发 者 提供 了 一 个 简单 直接 的 解决 方案 ， 而 
《Meteor 实 战 测 包含 了 为 开始 Meteor 开 发 所 需要 知道 的 一 切 。 它 涵盖 了 Meteor 栈 的 所 有 关键 部 分 : 
从 云 上 发 布 新 的 信息 到 每 个 在 线 用 户 的 数据 同步 系统 ， 在 数据 发 生变 化 时 重 绘 屏幕 的 响应 式 模 
板 、 事 件 和 表单 ， 同 构 的 用 户 账户 系统 、 路 由 、 包 和 应 用 安全 。 

此 外 ,《Meteor 实 战 》 涵 盖 了 Meteor 应 用 体系 结构 的 基本 知识 。 Meteor 是 一 个 全 栈 的 响应 式 平 
台 ， 这 意味 着 它 的 各 个 部 分 一 -从 数据 库 驱 动 程序 到 客户 端 模板 引擎 再 到 热 码 推 送 一 一 一 起 工 
作 ， 对 数据 的 变化 作出 实时 响应 。Meteor 是 一 种 同 构 平 台 ， 也 就 是 说 ， 无 论 在 哪里 ， 你 使 用 的 
JavaScript API 会 尽 可 能 相同 ， 比 如 在 浏览 器 、 移 动 设备 以 及 云 中 。 两 位 作者 在 书 中 通过 一 些 清 晰 
的 示例 解释 了 这 些 原则 ， 并 展示 了 如 何在 Meteor 的 开发 过 程 中 把 它们 整合 在 一 起 。 

从 我 们 发 布 最 时 的 版 本 到 现在 ,Stephan 和 Manuel 一 直 活 跃 在 Meteor 社 区 。 他 们 在 无 数 的 电子 
邮件 和 论坛 主题 中 为 Meteor 作 出 了 贡献 ， 现 在 他 们 撰写 了 这 本 有 趣 的 、 让 人 易于 接受 的 Meteor 图 
书 来 分 享 他 们 的 知识 。 
编码 愉快 ! 



























































































































































Matt DeBergalis 
Meteor 开 发 小 组 创始 人 


前 


2013 年 , 一 个 朋友 带 我 去 参加 和 鲁 尔 的 第 一 次 Mete 











ll 


or 聚会 ， 在 那里 我 遇见 了 Manuel。 那 时 ,在 


企业 工作 多 年 的 我 正 打算 基于 一 个 用 PHP 构 建 的 Web 平 台 开 始 创业 。 而 Manuel 向 我 们 介绍 了 


Meteor 早 期 的 情况 ， 它 解决 了 我 面临 的 许多 问题 ， 并 


且 使 网 络 编程 看 起 来 轻而易举 。 这 激发 了 我 























强烈 的 兴趣 ,我 回 到 家 就 立即 收集 了 有 关 这 个 新 平台 8 


更 多 资料 。 我 把 这 些 资 料 放 在 我 的 博客 上 ， 


而 且 因为 我 刚刚 读 过 一 篇 关于 SEO 的 文章 ,其 中 建议 使 用 夸大 的 言辞 来 吸引 人 们 的 注意 ,所 以 我 








大 胆 地 宣称 ， 这 里 提供 了 “学 习 Meteorjs 的 最 佳 资源 





'。 我 就 是 这 么 与 Meteor 结 缘 的 。 





2014 年 3 月 ,Manning 出 版 社 联系 我 , 问 我 是 否 有 兴趣 写 一 本 关于 前 景 光 明 的 Meteor 平 台 的 书 。 
他 们 看 到 了 我 的 博客 文章 , 并 坚信 我 的 相关 知识 够 丰富 , 足以 向 其 他 开发 者 介绍 这 个 平台 。 当然 ， 
我 同意 了 。 但 是 ， 尽 管 我 收集 了 我 认为 最 好 的 学 习 资 源 ， 我 却 不 知道 如 何 实 际 应 用 它们 。 我 仍然 
停留 在 PHP 的 世界 里 。 写 一 本 书 是 学 习 一 切 Meteor 相 关 知 识 的 绝 佳 机 会 ， 所 以 我 高 兴 地 同意 了 ， 















































但 我 还 是 首先 征询 了 Manuel 的 意见 ， 问 他 是 否 愿 意 和 


我 一 起 来 写 这 本 书 。 幸 运 的 是 ， 他 同意 了 ， 





所 以 我 们 便 一 起 来 解释 这 个 新 的 平台 。 


写 完 这 本 书 , 我 觉得 Manuel 的 博学 结合 我 自己 的 无 知 ,帮助 我 们 避免 了 针对 读者 做 太 多 假设 


的 陷阱 ， 并 在 实用 性 和 理论 深度 上 取得 了 良好 的 平衡 





我 们 觉得 这 本 书 的 内 容 足 以 让 你 了 解 Meteor 并 基于 此 开发 出 精彩 的 应 用 。 虽 然 我 们 不 能 解释 




















。 请 告诉 我 们 这 一 策略 是 否 真 的 有 效 。 











Meteor 工 作 中 的 每 个 细节 , 但 我 们 希望 这 些 基 础 知识 可 以 帮助 你 更 好 地 理解 现 有 的 文档 、 软 件 包 
和 源 代码 。 最 终 ，Meteor 和 《Meteor 实 战 》 将 能 够 帮助 你 把 想法 变 成 应 用 。 请 告诉 我 们 你 所 开发 
的 应 用 ! 你 可 以 通过 Twitter 联系 我 们 ， 也 可 以 利用 本 书 的 GitHub 仓 库 ， 还 可 以 在 这 本 书 的 作者 在 























线 论坛 发 表 文 章 。 我 们 很 想 听 到 你 的 反馈 ! 























Stephan Hochhaus 


致谢 


在 这 本 书 的 封面 上 ， 你 只 会 看 到 两 个 名 字 一 一 Manuel 和 Stephan， 但 有 很 多 好 心 人 为 这 本 书 
作出 了 贡献 ， 如 果 不 提 到 他 们 将 是 一 种 遗憾 。 首 先 , 也 是 最 重要 的 , 要 感谢 Manning 的 工作 人 员 ， 
尤其 是 Robin De Jongh， 他 相信 写 一 本 关于 Meteor 的 书 是 个 好 主意 ， 还 有 Ozren Harlovic， 他 与 我 
进行 了 第 一 次 联系 。 也 要 感谢 我 们 的 编辑 Sean Dennis 和 Dan Maharry ， 他 们 帮助 我 们 把 临 涩 的 技 
术语 言 变 成 可 理解 的 词汇 和 图 表 。 感谢 我 们 的 文字 编辑 Liz Welch, 他 不 得 不 帮 有 我 们 修正 大 量 用 错 
的 形 近 词 。 感 谢 我 们 的 校对 员 Barbara Mirecki， 以 及 其 他 许多 和 我 们 一 起 合作 的 Manning 幕 后 工 
作 人 员 。 

Meteor 社 区 对 这 本 书 的 创作 而 言 是 非常 重要 的 。 我 们 要 感谢 所 有 早期 ( 和 现在 ) 的 开发 者 ， 
他 们 使 用 Meteor、 在 网 络 上 发 表 文 章 、 开 发 包 、 拓 展 平台 的 界限 。 你 们 知道 我 说 的 是 谁 ! 

与 Manning 的 编辑 、 生 产 和 技术 人 员工 作 相当 愉快 ， 尽管 他 们 不 断 地 给 我 们 施 压 ， 以 使 这 本 
书 做 到 最 好 。 我 们 感激 这 种 压力 ， 这 是 值得 的 ! 

在 写 这 本 书 的 不 同 阶段 , 有 很 多 人 阅读 了 手稿 , 我 们 要 感谢 他 们 提供 了 宝贵 的 反馈 信息 : Carl 
Wolsey 、Charlie Gaines Cristian Antonioli、 Daniel Anderson、 Daniel Bertoi、 David DiMaria、 Dennis 
Hettema、 John Griffiths、 Jorge Bo、Keith Webster 、Patrick Regan 、Subhasis Ghosh、Tim Couger、 
Touko Vainio Kaila。 

也 要 感谢 我 们 的 技术 编辑 Kostas Passidis， 他 保证 了 我 们 的 技术 解释 是 准确 和 可 以 理解 的 。 
感谢 Al Krinker， 他 在 本 书 付 印 前 对 最 终 的 手稿 做 了 彻底 的 技术 审查 。 特 别 感谢 Matt DeBergalis 
为 本 书 作 序 。 

万 分 感谢 你 们 , 我 们 的 读者 , 特别 是 那些 在 这 本 书 只 有 几 音 的 时 候 就 相信 本 书 并 加 入 本 书 早 
期 预览 计划 的 人 。 你 们 的 反馈 、 兴 趣 和 鼓励 让 我 们 得 以 持续 前 进 ! 





































































































Stephan Hochhaus 


我 想 感 谢 Said Seihoub 让 我 去 参加 那 次 Meteor 聚 会 。 没 有 他 ， 我 将 不 会 写 这 本 书 。 也 非常 感 
谢 Manuel, 当 我 遇 到 问题 时 , 他 总 是 能 告诉 我 答案 。 写作 是 一 项 寂寞 的 事业 , 所 以 也 要 感谢 Meteor 
的 即时 聊天 频道 ， 在 我 拖延 时 陪伴 着 我 。 当 然 了 ,要 是 没有 你 们 ,这 本 书 可 能 在 2014 年 就 已 经 出 
版 了 ! 

也 要 感谢 Anton Bruckner 、Johann Sebastian Bach、Joss Whedon 和 Terry Pratchett 创 造 了 合适 的 




















2 致 谢 











工作 氛围 。 最 后 ,我 要 感谢 我 的 家 人 ， 他 们 对 我 表现 出 了 很 大 的 耐心 ， 每 个 月 我 都 告诉 他 们 我 写 
完了 一 章 ， 结 果 下 个 星期 又 回 到 这 一 章 重 写 ， 并 再 次 “完成 ” 它 。 




















Manuel Schoebel 


写 一 本 书 所 要 付出 的 努力 比 我 想象 的 多 得 多 , 但 这 是 一 个 伟大 的 旅程 , 它 帮助 我 更 深入 地 去 
挖掘 Meteor 的 细节 。 谢 谢 Stephan 邀 请 我 共同 写作 这 本 书 。 一 如 既往 地 ， 和 你 一 起 工作 非常 愉快 。 

在 这 本 书 的 写作 过 程 中 , 我 同时 做 着 另 一 件 事 一 一 创办 了 自己 的 公司 , 这 也 占据 了 我 大 量 的 
时 间 。Christina， 如 果 没 有 你 的 宽容 、 耐 心 和 支持 ， 这 两 件 事 我 都 不 可 能 做 好 ， 所 以 感谢 你 ， 你 
太 伟 大 了 ! 

有 一 个 家 庭 时 刻 在 背后 支持 你 是 一 种 难得 的 幸福 , 不 是 每 个 人 都 有 这 样 的 福 分 。 我 深 深 明 白 
这 一 点 并 万 分 感激 一 一 在 事情 变 得 困难 时 ， 你 们 总 是 能 够 带 给 我 内 心 的 宁静 。 

最 后 ， 我 感谢 每 天 都 致力 于 让 Web 更 加 精彩 的 所 有 人 。 这 不 仅 包括 来 自 Meteor 本 身 的 伙伴 ， 
而 且 也 包括 开发 新 的 软件 包 、 参 加 聚会 或 是 刚刚 开始 学 习 如 何 把 自己 的 想法 变 成 Web 应 用 的 每 个 
人 。 网 络 给 了 我 们 学 习 、 探 索 、 工 作 和 娱乐 的 自由 ， 比 我 们 过 去 所 知道 的 自由 还 要 多 。 这 是 一 个 
甚至 可 以 让 你 谋生 的 游乐 场 。 我 们 邀请 你 来 和 我 们 一 起 玩 ! 


































































































关于 本 书 





从 一 些 有 经 验 的 开发 人 员 那 里 ， 你 常 听 到 这 样 一 句 话 :“ 开 发 应 用 并 不 像 发 射 火 箭 那么 高 
深 。” 虽 然 开发 应 用 不 像 把 人 类 送 上 太空 那么 复杂 ， 但 对 新 手 来 说 它 可 能 让 人 望 而 生 旦 。 要 把 你 
的 应 用 放 在 Web 上 通常 需要 大 量 的 工具 和 服务 器 组 件 ， 更 不 要 说 移动 设备 了 。Meteor 的 目标 是 成 
为 一 个 游戏 规则 改变 者 。Meteor 的 创建 者 之 一 Nick Martin 这 样 说 道 : 


通过 Meteor， 我 们 希望 Web 应 用 的 开发 能 够 大 众 化 ， 可 以 让 任何 人 在 任何 地 方 创建 应 用 。? 


我 们 已 经 看 到 ， 一 些 稍 有 HTML 和 CSS 基 础 的 人 就 可 以 通过 Meteor 在 一 天 之 内 把 他 们 的 想法 
变 成 代码 。 因 此 , 我 们 相信 它 会 使 开发 变 得 更 容易 ,甚至 会 让 那些 从 来 不 认为 自己 是 开发 者 的 人 
开始 开发 应 用 。 

除非 有 一 个 好 老师 , 否则 你 可 能 需要 大 半天 的 时 间 来 了 解 Meteor 平 台 。 这 就 是 《Meteor 实 战 》 
的 用 武之 地 。 它 是 你 的 私人 教师 ， 将 引导 你 学 习 创建 应 用 的 各 个 主要 方面 ,不 管 你 想 开 发 Web 应 
用 还 是 移动 应 用 。 最 终 ， 你 将 能 够 把 自己 的 想法 转化 为 代码 。 如 果 你 在 了 解 Meteor 平 台 之 前 做 过 
这 件 事 ， 就 会 惊讶 于 Meteor 快 速 地 解决 了 一 些 最 常见 的 问题 。 

《Meteor 实 战 》 的 主要 读者 有 两 类 : 一 类 是 想 把 技能 扩展 到 服务 器 端的 前 端 开 发 者 ， 另 一 类 
是 具有 服务 器 开发 背景 的 、 想 转变 为 JavaScript 全 栈 开 发 者 的 Java、Ruby 或 PHP 开 发 者 。 这 本 书 不 
是 为 初学 者 撰写 的 ， 我 们 希望 你 以 前 已 经 开发 过 (或 至 少 尝 试 开发 过 ) 一 些 Web 应 用 。 

和 所 有 仍 在 使 用 中 的 工具 一 样 ，Meteor 一 直 在 不 断 变化 和 发 展 。 我 们 很 小 心地 在 书 中 教授 这 
个 平台 的 基本 原理 ,以 帮助 你 奠定 良好 的 基础 。 我 们 已 确认 , 后 面 章 节 中 描述 的 所 有 功能 都 可 以 
在 版 本 1.1 上 很 好 地 工作 。 


路 线 


本 书 分 为 三 个 部 分 。 

第 一 部 分 概述 了 Meteor 平 台 ， 介 绍 了 构成 Meteor 栈 的 各 种 组 件 和 概念 。 第 1 章 概 要 介绍 了 
Node.js、MongoDB、 同 构 性 及 响应 性 ， 然 后 你 将 在 第 2 章 中 创建 你 的 第 一 个 Meteor 应 用 。 

第 二 部 分 介绍 了 响应 式 应 用 的 基本 模块 。 每 一 章 侧 重 于 应 用 开发 的 一 个 方面 。 第 3 章 介绍 了 
模板 ， 第 4 章 介绍 了 如 何 使 用 数据 和 执行 CRUD 操 作 ， 第 5$ 章 结合 这 两 个 方面 强调 了 构建 响应 式 界 




















































































































QD http://blog.heavybit.com/blog/2014/04/01/meteor。 
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面 时 一 些 需 要 着 重 考虑 的 因素 ， 第 6 章 介绍 了 一 种 通过 引入 用 户 相 关 的 功能 来 保护 应 用 的 方法 。 
第 7 章 介绍 了 如 何 取代 Meteor 默 认 使 用 的 自动 数据 发 布 机 制 ， 涵 盖 了 Meteor 发 布 和 订阅 的 概念 ， 
以 及 如 何 使 用 方法 来 实现 另 一 个 层次 的 安全 。 客 户 端 和 服务 器 上 的 路 由 操作 都 使 用 了 流行 的 
Iron.Router 库 ， 这 将 在 第 8 章 中 讨论 。 第 9 章 教 你 如 何 使 用 包 来 扩展 Meteor 的 核心 功能 ， 你 可 以 使 
用 现 有 的 Isopack、npm 包 或 编写 自己 的 包 。 第 10 章 是 这 一 部 分 的 最 后 一 章 ， 包含 了 用 于 异步 操作 
的 服务 器 端 方法 、 外 部 API 访 问 和 文件 上 传 等 内 容 。 

第 三 部 分 则 更 进一步 ， 讨 论 了 应 用 的 构建 和 合理 部 署 。 第 11 章 解释 了 Meteor 的 构建 系统 、 代 
码 调试 ， 以 及 如 何 将 你 的 代码 转变 为 Web 和 移动 应 用 。 最 后 的 第 12 章 则 涉及 把 Meteor 应 用 到 生产 
环境 的 各 个 方面 。 

本 书后 面 有 三 个 附录 。 附 录 A 涵 盖 了 所 有 支持 平台 上 Meteor 的 安装 过 程 。 附 录 B 揭 示 了 
MongoDB 的 架构 以 及 用 来 实现 高 可 用 性 的 相关 组 件 ， 还 介绍 了 如 何 设 置 最 新 操作 日 志 (oplog 
tailing )， 这 是 Meteor 实 现 应 用 可 伸缩 性 背后 的 重要 技术 。 附 录 C 教 你 如 何 设置 反 向 代理 以 实现 多 
个 Meteor 服 务 器 之 间 的 负载 平衡 ， 提 供 静 态 内 容 服 务 并 启用 SSL。 


先决 条 件 


要 想 从 这 本 书 中 获得 最 大 收益 ， 你 需要 在 系统 上 安装 Meteor。 安 装 Meteor 的 方法 可 以 在 附录 
A 中 找到 ， 也 可 以 在 Meteor 的 官方 网 站 (http:/meteorcom ) 上 找到 。 

在 本 书 中 ， 我 们 假定 你 至 少 对 HTML 、CSS 和 JavaScript 有 基本 的 了 解 。 你 应 该 知道 如 何 使 用 
对 象 ， 并 使 用 过 回调 函数 。 对 数据 库 的 工作 方式 有 基本 的 了 解 是 有 帮助 的 ,但 不 是 必需 的 。 阅 读 
本 书 时 ， 你 不 需要 有 任何 使 用 服务 器 端 JavaScript 甚 至 是 Nodejs 的 经 验 。 


代码 


本 书 中 的 所 有 代码 都 可 从 Manning 网 站 下 载 : http:/www.manning.com/books/meteor-in-action。 
你 也 可 以 在 GitHub 上 找到 它 : http://www.github.com/meteorinaction。 

为 了 便于 学 习 ， 每 一 章 都 建 了 一 个 单独 的 Git 仓 库 。 因 为 不 是 所 有 的 代码 都 印 在 书 中 ， 所 以 
我 们 为 每 个 仓库 添加 了 标签 ， 方 便 你 在 迷茫 的 时 候 找到 方向 。 例 如 ， 当 你 开始 第 2 章 时 ， 可 以 参 
考 标签 为 begin 的 代码 来 查看 起 始 代码 。 如 果 你 想 跳 过 前 面 的 部 分 ， 直接 查 看 服务 器 启动 时 添加 
的 夹具 代码 ， 可 以 查看 标签 为 1isting-2.9 的 代码 。 


作者 在 线 


购买 英文 版 的 读者 可 免费 访问 Manning 出 版 社 的 专 有 论坛 ”, 并 可 以 在 那里 发 表 关 于 本 书 的 评 
论 , 咨询 技术 问题 ,获得 作者 和 其 他 用 户 的 帮助 。 要 访问 和 订阅 论坛 ， 可 在 浏览 带 中 键入 这 个 地 



























































































































































Q@ 中 文 版 意见 和 勘误 请 提交 到 图 灵 社 区 : www.ituring.com.cn/book/1837。 
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址 : http://www.manning.com/books/meteor-in-action。 这 个 页 面 提供 了 一 些 基本 信息 , 包括 注册 之 
后 如 何 进 入 论坛 、 它 可 以 提供 什么 样 的 帮助 以 及 论坛 上 的 行为 准则 等 。 

Manning 承 诺 为 读者 之 间 以 及 读者 和 作者 之 间 的 有 效 交 流 提供 一 个 平台 。 但 这 并 不 意味 着 作 
者 会 有 任何 特定 程度 的 参与 ， 他 们 对 本 书 论坛 的 贡献 是 自愿 的 〈 无 报酬 的 )。 我 们 建议 你 试 着 问 
他 们 一 些 具 有 挑战 性 的 问题 ， 以 免 他 们 的 兴趣 转移 到 别 的 地 方 ! 

只 要 本 书 还 在 销售 , 作者 在 线 论坛 和 以 前 所 讨论 内 容 的 归档 文件 就 都 可 以 在 出 版 社 的 网 站 上 
访问 到 。 


关于 作者 


Stephan Hochhaus 偶 然 在 Perl 语言 中 找到 了 自己 的 定位 , 然后 开始 了 他 的 开发 职业 生涯 。 他 为 
大 型 企业 开发 可 扩展 的 Web 解 决 方案 ， 学 习 铅 研 PHP 、C# 甚 至 Java。 工 作 多 年 以 后 ， 他 于 2013 年 
开始 创业 , 为 中 小 企业 开发 Web 应 用 。 自从 遇见 了 Meteor, 他 觉得 自己 今后 就 应 该 使 用 JavaScript。 
Stephan 也 为 引入 Scrum "或 进行 持续 交付 开发 的 团队 提供 咨询 服务 。 他 拥有 波 鸿 鲁 尔 大 学 的 语言 
学 和 社会 心理 学 硕 十 学位， 能够 熟练 地 使 用 正则 表达 式 。 

Manuel Schoebel 拥 有 杜 伊 斯 堡 一 埃 森 大 学 〈 埃 森 校区 ) 商业 信息 学 文凭， 专注 于 Web 创 业 。 
Manuel 花 费 了 大 量 时 间 辅 导 创 始 人 、 开 发 MVP， 甚 至 创立 了 多 家 公司 。 他 从 2012 年 开始 接触 
Meteor， 当 时 这 个 平台 还 处 于 起 步 阶 段 。 他 写 了 一 些 有 价值 的 博客 文章 ， 很 快 就 成 为 了 Meteor 社 
区 中 著名 的 专家 。 自 2013 年 以 来 ，Manuel 在 他 的 项 目 中 就 只 使 用 Meteor。 

Manuel 和 Stephan 一 起 组 织 了 德国 科隆 和 和 鲁 尔 地 区 的 Meteor 聚 会 , 把 Meteor 开 发 者 聚 在 一 起 交 
流 思想 、 探 讨 新 的 发 展 。 
关于 书 名 
通过 介绍 、 概 述 以 及 操作 实例 ,“ 实 战 ” 系 列 图 书 的 目的 是 帮助 学 习 和 记忆 。 根 据 认 知 科学 
的 研究 ， 人 们 记 住 的 东西 是 他 们 在 自我 激励 的 探索 中 发 现 的 东西 。 

虽然 在 Manning 没 有 一 个 人 是 认 知 科学 家 ， 但 我 们 相信 ， 要 想 使 学 到 的 东西 终生 不 忘 ， 必 须 
经 过 探索 、 把 玩 、 复 述 所 学 这 几 个 阶段 。 只 有 经 过 积极 的 探索 ， 人 们 才能 理解 并 记 住 新 事物 ， 也 
就 是 掌握 新 的 东西 。 人 类 在 实战 中 学 习 ， 而 “实战 ”系列 图 书 的 一 个 重要 特点 就 是 实例 驱动 。 它 
鼓励 读者 尝试 新 的 事物 、 把 玩 新 的 代码 、 探 索 新 的 想法 。 

给 这 本 书 起 “实战 ”这 样 的 书 名 还 有 男 一 个 更 普遍 的 原因 : 我 们 的 读者 都 很 忙 。 他 们 用 书 
来 完成 一 项 工作 或 解决 一 个 问题 。 他 们 需要 的 是 这 样 的 书 : 可 以 让 他 们 轻松 地 跳 进 跳出 ， 只 在 
需要 的 时 候 学 习 想 学 的 。 他 们 需要 有 助 于 行动 的 书 。 这 个 系列 的 图 书 就 是 为 这 样 的 读者 准备 的 。 















































































































































QD Scrum 是 迭代 式 增 量 软件 开发 过 程 ， 通 常用 于 敏捷 软件 开发 。 一 一 译 者 注 














天 于 封面 图 片 





本 书 的 封面 图 片 是 一 个 “ 挑 夫 ”一 一 一 个 小 工 、 水 手 或 码头 工人 ,看 着 似乎 很 好 斗 。 搬 图 取 


























自 Sylvain Maréchal 在 法 国 出 版 的 四 卷 区 域 服饰 习俗 概要 的 19 世 纪 版 ,其 中 每 幅 插图 都 是 手工 精心 
绘制 和 着 色 的 。Marechal 丰 富 的 收藏 生动 地 提醒 我 们 ， 仅 仅 在 200 年 前 ， 世 界 上 的 城镇 和 区 域 文 




















化 是 多 么 不 同 。 各 个 区 域 彼此 孤立 ， 人 们 说 着 不 同 的 方言 和 语言 。 在 街头 或 在 农村 ， 仪 通过 衣着 





就 很 容易 确定 他 们 生活 的 地 方 、 从 事 的 行业 和 社会 地 位 。 




















但 是 从 那 时 起 ,服饰 已 经 改变 , 地 区 的 多 样 性 也 已 经 慢 慢 消失 了 。 现在 人 们 已 很 难 分 辩 来 自 
不 同 大 陆 的 居民 , 更 不 用 说 不 同城 镇 或 区 域 的 居民 了 。 也 许 文 化 的 多 样 性 已 经 被 我 们 多 样 化 的 个 














人 生活 一 一 当然 是 更 加 多 样 化 和 快 节奏 的 高 科技 生活 一 一 取代 了 。 


如 今 ， 很 难说 出 一 本 计算 机 书 和 另 一 本 的 区 别 。Manning 利 用 图 书 的 封面 来 颂扬 计算 机 事业 








的 创造 性 和 原创 性 ， 这些 封面 都 反映 了 两 个 世纪 以 前 各 地 区 丰富 多 彩 的 生活 ， 它 人 
的 图 片 重新 获得 生机 。 








] 通 过 Maréchal 





第 一 部 分 “看 ， 一 颗 流星 ! 
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看 ， 一 颗 流 星 ! 





第 一 部 分 概述 Meteor (流星 ) 平台 的 各 个 组 成 部 分 以 及 它们 是 如 何 协作 的 。 我 们 将 介绍 
Node.js、MongoDB 以 及 响应 式 编程 的 概念 。 你 将 在 第 1 章 中 全 面 理解 Meteor 平 台 的 整个 技术 
栈 ， 在 第 2 章 中 构建 你 的 第 一 个 Meteor 应 用 。 


构建 应 用 程序 的 更 好 方式 








本 章 内 容 

口 Meteor 背 后 的 故事 

口 Meteor 栈 

口 全 栈 式 JavaScript、 响 应 和 分 布 式 平台 
口 Meteor 平 台 的 核心 部 件 

口 使 用 Meteor 的 优点 和 缺点 

口 Meteor 应 用 解析 





正如 我 们 所 知道 的 那样 ， 流 星 ee 以 改变 生活 著称 。 它 们 能 




















殉 悉 龙 炎 绝 ， 或 者 迫使 布 


和 鲁 斯 . 威 利 斯 为 拯救 人 类 而 牺牲 生命 "。 本 书 讲述 的 是 一 颗 影 响 Web 开 发 的 流星 ， 但 它 不 会 威胁 
ee a 相反 ， 它 将 提供 一 种 更 好 的 方式 来 构建 应 用 程序 。Meteor 借 用 几 个 现 有 的 工具 














和 库 ,， 将 它们 与 新 的 思想 以 及 新 的 库 、 标 准 和 服务 结合 起 来 ， 并 将 它们 拥 








人 的 生态 系 汉 几 O 


Meteor 是 基于 MEAN 栈 ”的 开源 应 用 开发 平台 。 该 平台 的 客户 端 刀 














JavaScript API。 它 专注 于 实时 的 响应 式 应 用 、 快 速 原型 开发 和 代码 重用 。 


作为 开发 者 ， 你 知道 一 旦 打开 浏览 右 的 源码 视图 ， 所 有 Web 应 用 程序 都 只 














绑 在 一 起 ， 为 开发 易 用 


1 服务 器 端 使 用 一 致 的 


4 是 HTML 、CSS 和 


JavaScript 的 组 合 。 像 Google 、Twitter 和 Facebook 这 样 的 巨头 在 网 站 开发 上 取得 了 令 人 印象 深刻 的 
成 果 ， 它 们 使 得 网 站 看 起 来 更 像 是 桌面 应 用 。Google Maps 的 流畅 和 Facebook Messenger 的 直接 ， 
使 得 用 户 对 于 互联 网 上 所 有 的 网 站 具有 更 高 的 期 望 。Meteor 使 你 能 够 满足 这 些 高 期 望 ， 因 为 它 提 
供 了 所 有 基础 设施 功能 ， 如 数据 订阅 和 用 户 处 理 ， 让 你 专注 于 实现 业务 功能 。 
本 章 将 告诉 你 Meteor 如 何 让 开发 变 得 更 容易 。 我 们 先 大 致 了 解 它 的 来 历 ， 然 后 将 重点 放 在 它 


























什么 组 成 以 及 如 何 使 用 它 来 快速 构建 应 用 。 




































































中 来 自 布鲁斯 ， 威 利 斯 主演 的 电影 《绝世 天 劫 》 影片 中 布鲁斯 ， 威 利 斯 为 拯救 人 类 需要 阻止 巨型 














陨石 撞击 地 球 。 








@ MEAN 栈 是 指 所 有 构建 于 MongoDB 、Node.js、Angular 和 Express.js 之 上 的 应 用 。MEAN 栈 有 几 种 不 同 的 形式 ， 上 








如 MEEN 栈 ， 它 指 的 是 MongoDB 、Emberjs、Express 和 Node.js。 有 时 这 个 词 
用 NoSQL 数 据 库 的 任何 框架 。 
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FNode.js 之 上 并 使 
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1.1 Meteor 简介 


如 果 看 一 看 最 近 几 年 Web 开 发 的 状况 ， 你 会 发 现 两 个 明显 的 趋势 。 首 移 ， 应 用 程序 变 得 更 加 
强大 , 通常 无 法 与 桌面 应 用 程序 区 分 开 。 坦 率 地 说 ,用 户 并 不 关心 应 用 背后 的 技术 ,他们 只 是 希 
望 有 良好 的 用 户 体验 。 这 包括 对 点 击 的 即时 响应 .与 其 他 用 户 的 实时 交互 以 及 与 其 他 服务 的 集成 。 
其 次 是 语言 、 库 、 工 具 和 工作 流程 的 数量 在 迅速 增长 ， 以 至 于 开发 人 员 不 可 能 跟 上 所 有 的 趋势 。 
因此 ， 我 们 可 以 总 结 出 当前 的 Web 开 发 状况 : 

(1) 用 户 期 望 应 用 程序 使 用 起 来 更 加 方便 ; 

(2) 开发 人 员 和 希望 不 用 担心 如 何 让 不 同 的 库 一 起 工作 ， 或 者 写 基 础 设施 代码 。 


1.1.1 _ Meteor 背后 的 故事 


当 Geoff Schmidt 、Matt DeBergalis 和 Nick Martin 被 创业 加 速 器 Y Combinator 接 受 以 后 ,他 们 计 
划 创 建 一 个 旅游 推荐 网 站 。 但 在 和 其 他 创业 公司 进行 交流 时 , 他 们 意识 到 这 些 创业 公司 正在 努力 
解决 他 们 在 开发 Asana 时 已 经 解决 的 问题 ,Asana 是 一 个 用 于 合作 项 目 和 任务 管理 的 在 线 平 台 。 
此 ， 他 们 改变 了 计划 ,决定 创建 一 个 开源 平台 ,为 Web 应 用 程序 提供 一 个 坚实 的 基础 ， 使 得 这 些 
应 用 使 用 起 来 像 桌面 应 用 程序 一 样 流畅 。 

2011 年 12 月 1 日 ，Meteor 开 发 小 组 ( Meteor Development Group ，MDG ) 发 布 了 Skybreak" 的 
第 一 个 预览 版 ， 这 个 项 目 很 快 就 更 名 为 Meteor。 仅 用 了 八 个 月 ,该 项 目 就 获得 了 1120 万 美元 的 资 
金 支 持 , 上 且 投资 者 都 是 行业 中 的 著名 人 士 或 公司 , 比如 Andreessen Horowitz、Matrix Partners、Peter 
Levine ( XenSource 前 任 首席 执行 官 )、Dustin Moskovitz ( Facebook 联 合 创 始 人 ) 和 Rod Johnson 
(SpringSource 创 始 人 )。Meteor GitHub 库 从 那 时 起 就 是 GitHub 最 受 欢 迎 的 20 大 库 之 一 ， 并 在 其 1.0 
版 本 发 布 几 天 以 后 一 跃 成 为 GitHub 最 受 欢迎 库 的 第 11 名 。 该 项 目的 星星 数 比 Linux 内 核 .Mac OS X 
的 包 管 理 程序 homebrew 以 及 backbone.js 都 要 多 。 

为 什么 Meteor 引 起 了 开发 者 如 此 强烈 的 兴趣 ?因为 它 不 需要 创建 低级 别 的 基础 设施 ( 如 数据 
同步 ) 或 管道 来 精简 和 编译 代码 ， 而 是 让 开发 人 员 专 注 于 业务 功能 。 获 得 了 超过 1100 万 美元 的 资 
金 后 , 投资 者 发 现 Meteor 很 有 吸引 力 。 类 似 用 于 服务 器 虚拟 化 的 免费 虚拟 机 管理 程序 Xen, 或 Java 
的 应 用 服务 器 JBoss，Meteor 开 发 团队 最 终 将 会 提供 针对 大 企业 的 额外 工具 。 

Meteor 开 发 团队 把 这 个 项 目 分 成 四 个 领域 。 

口 工具 : 比如 命令 行 界面 ( command-line interface，CLI )， 它 是 介 于 构建 工具 ( 如 make ) 和 

包 管 理 器 (如 node 包 管理 器 npm ) 之 间 的 一 个 混合 工具 。 它 用 以 处 理 整 个 构建 流程 ， 为 把 
应 用 程序 部 署 到 Web 或 移动 设备 做 准备 。 
口 软件 库 集合 : 一 套用 以 提供 功能 的 核心 包 。 这 些 功能 可 以 被 自 定 义 包 或 者 Node.js 模 块 扩 
展 ， 其 中 Node.js 模 块 可 以 通过 npm 来 安装 。 
口 标准 : 如 基于 WebSocket 的 分 布 式 数据 协议 ( Distributed Data Protocol，DDP )。 
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口 服务 : 如 官方 的 包 服务 器 或 编译 集群 。 
所 有 的 Meteor 项 目 都 可 以 使 用 统一 的 API 来 访问 ， 因 此 开发 人 员 不 需要 知道 哪些 组 件 构成 了 
整个 Meteor 栈 。 











1.1.2 ”Meteor 栈 


简单 地 说 ，Meteor 是 完全 使 用 JavaScript 创 建 富 Web 应 用 程序 的 开源 平台 。 它 在 同一 个 框架 下 
捆绑 并 提供 所 有 必需 的 组 件 。 它 由 以 下 几 部 分 组 成 : Node.js、MongoDB、 实 际 的 应 用 程序 代码 ， 
以 及 一 个 强大 的 CLI 工 具 ， 该 工具 结合 了 npm 和 make 的 功能 。 因 此 ， 它 不 仅仅 是 服务 器 进程 和 库 
的 组 合 。 有 些 人 喜欢 把 它 称 为 完整 的 生态 系统 ， 而 不 是 一 个 框架 。 但 是 ， 即 使 它 超越 了 其 他 Web 
框架 所 能 提供 的 功能 ， 从 本 质 上 说 它 仍 然 依赖 于 一 个 栈 来 运行 应 用 程序 。 

Meteor 栈 (参见 图 1-1 ) 是 MEAN 家 族 的 成 员 ， 这 意味 着 它 在 服务 器 端 使 用 Node.js。Node.js 
是 一 个 事件 驱动 的 、 高 度 可 扩展 的 JavaScript 运 行 库 ， 它 运行 于 服务 器 上 。 它 的 功能 和 LAMP 
(Linux、Apache、MySQL、PHP ) 栈 中 的 Apache Web 服 务 器 一 样 。 


使 用 同样 的 代码 库 来 部 



































































































































署 应 用 程序 到 Web 和 移 
动 设备 
移动 设 和 
浏览 器 
应 用 
4 
EL 应 用 程序 可 以 利用 许多 软件 包 
提供 的 功能 ”如 OAuth 登 录 、 
Sl 响应 式 用 户 界面 和 请 求 路 由 
CLI 工 具 管 理 构建 过 | 应 用 程序 代码 | 二 和 
程 、 软 件 包 管理 、 应 era tn 









































用 程序 的 部 署 和 其 他 。“、、、 二 Wa a 


常见 任务 | 
: = | MongoDB 是 Meteor 的 默认 数据 
| | 库 。 作 为 一 个 NoSQL 数 据 库 ， 


| 它 存储 文档 而 不 是 表 
CLI 工 具 服务 器 


图 1-1 Meteor 栈 的 应 用 运行 在 基于 Node.js 和 MongoDB 的 软件 包 上 


所 有 的 数据 通常 存储 在 MongoDB 中 ， 这 是 一 个 面向 文档 的 NoSQL 数 据 库 。 虽 然 Meteor 有 计 
划 支 持 其 他 ( 基于 SQL ) 的 数据 库 系 统 , 但 目前 唯一 推荐 的 数据 库 是 Mongo。 它 提供 了 JavaScript 
API， 用 以 访问 所 有 以 文档 或 对 象形 式 存 储 的 内 容 。 可 以 使 用 浏览 器 中 运行 的 语言 来 访问 数据 ， 
这 正 是 Meteor 用 以 真正 实现 全 栈 开发 的 优势 。 
从 零 开始 创建 Web 应 用 程序 所 需要 的 所 有 软件 和 库 ， 以 包 的 形式 被 拥 绑 在 一 起 。 基 于 这 些 ， 
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开发 人 员 可 以 马上 开始 开发 工作 。 这 些 包 包括 一 个 响应 式 用 户 界面 库 (Blaze， 火 焰 )、 用 户 账户 
管理 (account， 账 户 ) 和 一 个 进行 透明 性 响应 式 编程 的 库 〈 Tracker )。 

Meteor 的 CLI 工 具 使 开发 者 能 够 快速 建立 一 个 完整 的 开发 环境 。 无 需 知道 怎样 安装 或 配置 任 
何 服务 器 软件 ; Meteor 帮 助 处 理 了 基础 设施 方面 的 所 有 工作 。 它 既是 一 个 可 与 make 或 grunt 相 媲 
美的 构建 工具 ， 同 时 还 是 一 个 类 似 于 apt 或 npm 的 包 管理 器 。 例 如 ， 它 可 以 实时 编译 诸如 LESS 或 
者 CoffeeScript 这 样 的 预 处 理 语言 ， 不 需要 预先 设置 工作 流程 ， 也 可 以 通过 一 个 命令 来 添加 
Facebook 的 OAuth 认 证 。 最 后 ，CLI 工 具 打 包 的 应 用 程序 可 以 运行 在 不 同 的 客户 端 平台 上 ， 比 如 
在 Web 浏 览 絮 上 或 者 是 原生 的 移动 应 用 上 。 

栈 的 所 有 部 分 都 是 无 颖 集成 的 ， 所 有 的 核心 包 都 经 过 了 测试 ， 可 以 很 好 地 协作 。 另 一 方面 ， 
在 需要 的 时 候 ， 完 全 可 以 将 栈 的 一 部 分 切换 为 其 他 技术 栈 。 你 可 以 不 使 用 Meteor 栈 的 全 部 ， 比 如 
可 以 只 使 用 它 的 服务 器 端 组 件 ， 而 在 客户 端 使 用 Angularjs， 或 者 在 使 用 Java 后 端的 同时 使 用 
Meteor 的 前 端 ， 为 所 有 客户 端 提供 实时 更 新 。 


1.1.3 同 构 框 架 : 全 栈 式 JavaScript 


Meteor 运 行 在 Nodejs 上 ， 它 把 应 用 逻辑 移动 到 浏览 器 端 ， 这 就 是 通常 所 说 的 单 页 面 应 用 
(single-page application )。 整 个 栈 使 用 相同 的 语言 ， 这 使 得 Meteor 成 为 一 个 同 构 平 台 。 基 于 此 ， 
同样 的 JavaScript 代 码 ， 可 以 用 在 服务 器 端 、 客 户 端 甚至 是 数据 库 上 。 

虽然 有 许多 框架 在 客户 端 和 服务 器 端 使 用 相同 的 语言 , 但 大 部 分 时 间 它 们 不 能 在 两 个 实例 之 
间 共 享 代 码 ， 因 为 这 些 框架 不 是 紧密 集成 的 ， 例 如 ， 它 们 在 前 端 使 用 Angular， 在 后 端 使 用 
Express.js。 Meteor 是 真正 的 全 栈 框架 , 因为 它 使 用 了 一 个 简单 统一 的 接口 暴露 出 所 有 的 核心 功能 ， 
这 个 接口 可 以 使 用 在 服务 器 端 和 浏览 器 中 , 甚至 可 以 用 来 访问 数据 库 。 要 开始 使 用 它 ， 你 不 必 学 
习 多 个 框架 ， 而 且 它 使 得 代码 的 可 重用 性 比 只 使 用 一 种 语言 更 好 。 

为 了 从 浏览 器 访问 数据 库 ，Meteor 包 含 了 微型 数据 库 。 它 们 精确 模拟 了 数据 库 的 API。 在 浏 
览 絮 中 ，Minimongo 使 开发 人 员 能 够 使 用 与 在 MongoDB 的 控制 台中 相同 的 命令 。 

所 有 的 Meteor 应 用 程序 都 运行 在 Nodejs 上 ，Node.js 服 务 器 解释 采用 JavaScript 编 写 的 应 用 程 
序 代 码 。 与 许多 其 他 应 用 程序 服务 器 不 同 的 是 ，Node.js 只 使 用 一 个 线程 。 在 多 线程 环境 中 , 一 个 
写 人 磁盘 的 线程 可 以 阻塞 所 有 其 他 的 线程 , 这 会 暂停 响应 所 有 的 客户 端 请 求 , 直到 这 个 写 操作 完 
成 。 然 而 , Node.js 能 够 把 所 有 的 写 请 求 放 入 队列 并 继续 处 理 其 他 请 求 ,有 效 地 避免 了 竞争 情况 ( 即 
两 个 操作 试图 同时 更 新 相同 的 数据 )。 应 用 程序 代码 从 上 到 下 顺序 运行 ， 或 同步 运行 。 

耗 时 的 操作 ， 比 如 磁盘 或 数据 库 1/O, 会 从 同步 序列 中 分 离 。 它 们 将 以 异步 方式 处 理 。Node.js 
不 会 等 到 这 些 操 作 结 束 , 但 它 会 给 这 些 操作 附加 一 个 回调 函数 , 一 旦 操作 完成 就 使 用 该 回调 函数 
重 访 这 些 操作 的 结果 , 而 Nodejs 在 此 同时 会 处 理 队 列 中 的 下 一 个 请 求 。 为 了 更 好 地 理解 同步 和 异 
步 事件 ， 让 我 们 考虑 一 个 熟悉 的 编程 场景 : 加 热 冷 冻 的 比萨 。 

1-2 详 细 列 出 了 准备 从 冰箱 中 取出 食物 的 所 有 步骤 。 每 一 步 都 是 一 个 事件 ， 虽 然 这 只 是 我 
们 生活 中 一 个 非常 小 的 事件 。 同 步 事 件 流 中 发 生 的 每 一 个 事件 都 需要 我 们 的 关注 : 我 们 把 比萨 从 
冰箱 中 取出 ， 打 开 包装 ， 预 热 烤箱 ， 放 入 比萨 ,设置 闹 钟 。 此 时 是 我 们 真正 启动 分 文子 进程 的 时 
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刻 。 本质 上 ， 用 烤箱 加 热 比 萨 是 一 个 耗 时 的 IO 进程 。 我 们 设置 了 曾 钟 ， 证 它 在 完成 时 通知 我 们 ， 
所 以 我 们 可 以 关注 更 重要 的 事情 , 比如 学 习 Meteor 框 架 。 当 闸 钟 响起 的 时 候 , 它 唤 起 我 们 的 注意 ， 
并 把 子 进程 处 理 的 结果 放 回 到 同步 事件 流 。 然 后 我 们 可 以 把 比萨 取出 ， 继 续 做 其 他 事情 。 


















































同步 事件 流 


























从 冰箱 中 
取出 比萨 
















预 热 烤箱 之 放 入 比萨 


学 习 Meteor 框 架 


回调 函数 
加 热 比萨 > 


图 1-2 ”加 热 比 萨 时 的 同步 和 异步 事件 


正如 你 在 这 个 例子 中 看 到 的 , 加 热 比 萨 不 会 阻塞 你 的 同步 事件 流 。 但 是 ， 如 果 你 的 同事 也 想 
要 热 比 萨 ， 可 烤箱 里 只 能 放 一 个 比萨 ,他 的 请 求 就 需要 排队 , 这 有 效 地 阻止 了 办 公 室 里 所 有 其 他 
人 都 来 热 比萨 。 

在 Node,js 中 ， 只 要 服务 器 在 运行 ， 同 步 流 就 会 发 生 。 这 被 称 为 事件 循环 (eventloop )。 图 1-3 
演示 了 事件 循环 如 何 处 理 用 户 的 请 求 。 它 每 次 从 队列 中 取出 一 个 事件 , 执行 相关 的 代码 ,执行 结 
束 时 ,， 下 一 个 事件 被 拉 人 循环 。 但 有 些 事件 可 能 会 被 转移 到 一 个 线程 池 ， 例 如 ， 写 人 磁盘 或 数据 
库 的 操作 。 一 有 旦 写 操作 完成 ， 将 执行 一 个 回调 函数 ， 操 作 返 回 的 结果 再 回 到 事件 循环 中 。 
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图 1-3 ”Node.js 的 事件 循环 


通常 , 开发 人 员 需 要 知道 如 何 编写 代码 以 充分 利用 事件 循环 , 并 且 需 要 知道 哪些 函数 是 同步 
的 ， 哪 些 是 异步 的 。 异 步 函 数 使 用 得 越 多 ， 回 调 函 数 就 越 多 ， 代 码 可 能 会 因此 变 得 相当 混乱 。 

















1.1 Meteor 简介 了 








幸运 的 是 ，Meteor 充 分 利用 了 事件 循环 的 力量 ,使 这 件 事 情 变 得 很 容易 ， 因 为 你 不 必 担 心 写 
异步 代码 。 它 在 背后 使 用 了 一 个 叫 作 纤维 (fiber ) 的 概念 。 纤 维 为 依次 执行 异步 功能 ( 任务 ) 的 
事件 循环 提供 了 一 个 抽象 层 。 它 不 需要 明确 指定 回调 函数 , 因此 可 以 使 用 你 所 熟悉 的 同步 方式 来 
执行 异步 任务 。 








1.1.4 在 浏览 器 中 处 理 : 在 分 布 式 平台 上 运行 


当 后 台 运 行 一 个 Java、PHP 或 Rails 应 用 程序 时 ， 处 理 过 程 在 远离 用 户 的 地 方 发 生 。 客 户 端 通 
过 调用 URI 来 请 求 数据 。 作 为 回应 , 应 用 程序 从 数据 库 中 获取 数据 ,执行 一 些 处 理 并 创建 HTML ， 
然后 将 结果 发 送 到 客户 端 ,请求 相同 信息 的 客户 端 越 多 ， 则 服务 器 缓存 得 越 多 。 新 闻 网 站 以 这 种 
模式 可 以 工作 得 很 好 。 

在 每 个 用 户 都 能 够 创建 高 度 个 性 化 视图 的 情况 下 ， 单 一 的 处 理 实例 很 快 就 会 变 成 一 个 瓶颈 。 
以 Facebook 为 例 : 任意 两 个 人 都 不 会 看 到 完全 相同 的 墙 ， 每 面 墙 都 需要 为 每 个 用 户 单 独 计算 。 这 
给 服务 器 端 带 来 很 大 压力 ， 而 客户 端 在 大 多 数 时 候 则 处 在 空闲 状态 ， 等 待 响应 。 

当 客 户 端 的 处 理 能 力 相 对 有 限时 ， 这 是 完美 的 模式 ， 但 现在 单个 的 iPhone 已 经 拥有 了 上 比 Web 
早期 的 大 多 数 超级 计算 机 更 强 的 计算 能 力 。Meteor 利 用 了 这 个 计算 能 力 ， 把 大 部 分 处 理 移 到 了 客 
户 端 ,智能 前 端 从 服务 器 请 求 数据 ,并 在 浏览 器 或 移动 设备 上 装配 文档 对 象 模 型 ( Document Object 
Model，DOM )， 参 见 图 1-4。 


传统 Web 数据 呈现 个 
<html> 
用 户 






























































<ul> 

服务 器 <li>Shirts</1i> 浏览 器 
<li>Shoes</1i> 
<li>Sweaters</1i> 

</ul> 

</hntml> 


数据 人 | © 
[{ name: "Shirts"}, A 
用 户 





























现代 富 Web 
应 用 程序 
{ name: "Shoes"}, 


服务 器 { name: "Sweaters"}] 浏览 器 














图 1-4 ”传统 与 现代 富 Web 应 用 程序 的 区 别 

这 种 以 客户 端 为 中 心 的 方法 带 来 了 两 个 显著 的 优势 。 

口 需要 在 服务 器 和 客户 端 之 间 进 行 传输 的 数据 更 少 ， 这 基本 上 意味 着 响应 更 快 。 

口 由 于 大 多 数 工 作 是 在 每 个 独立 的 客户 端 上 进行 的 ， 因 此 服务 器 的 处 理 不 太 可 能 因为 耗 时 
的 请 求 而 被 其 他 的 用 户 阻 塞 。 

传统 的 客户 端 - 服 务 器 架构 基于 无 状态 的 连接 。 客 户 端 请 求 一 次 数据 ， 服 务 器 响应 ， 并 关闭 
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连接 。 其 他 客户 端 可 能 会 更 新 数据 , 但 除非 用 户 明 确 发 出 一 个 服务 器 请 求 ， 否则 他 们 不 会 看 到 更 
新 ， 只 会 看 到 网 页 的 历史 快照 。 没 有 从 服务 器 到 客户 端的 反馈 通道 来 推送 更 新 过 的 内 容 。 
想象 一 下 ,你 打开 本 地 电影 院 的 网 站 ,看 到 乔 斯 . 韦 登 的 新 电影 首 映 只 有 两 个 座位 了 。 当 你 
在 讨论 是 否 应 该 去 的 时 候 , 别人 买 了 这 两 张 票 。 但 你 的 浏览 器 一 直 告 诉 你 还 有 两 个 座位 ， 直 到 你 
再 次 点 击 时 才 发 现 票 已 经 卖 完了 。 真 倒霉 。 
把 处 理工 作 从 单一 的 服务 器 转移 到 多 个 客户 端 ， 这 涉及 分 布 式 计算 平台 的 方向 。 在 这 样 的 分 
布 式 环境 中 ， 数 据 需 要 在 两 个 方向 上 传输 。 在 Meteor 框 架 中 ,浏览 器 是 一 个 智能 客户 端 。 连 接 不 
再 是 无 状态 的 ; 当 订 阅 的 内 容 更 新 时 ,服务 器 可 以 发 送 数 据 到 客户 端 。 图 1-5 显 示 了 这 两 种 体系 结 
构 。 为 允许 客户 端 和 服务 器 之 间 进 行 双向 通信 ，Meteor 使 用 了 WebSocket。 使 用 一 个 标准 化 的 分 布 
式 数据 协议 (DDP ) 来 交换 信息 。DDP 简 单 易 用 ， 可 用 于 许多 其 他 编程 语言 ， 如 PHP 或 Java 等 。 

























































































客户 训 














服务 器 。 ] 客户 端 








传统 的 客户 端 -服务 器 架构 分 布 式 应 用 平台 





”只 有 当 客户 端 请 求 新 内 容 时 ， | “服务 器 可 将 更 新 的 内 容 推 给 所 有 
浏览 器 才 会 发 生 更 新 | 连接 的 客户 端 

”其 他 客户 端 所 做 的 更 改 只 在 请 “由 一 个 客户 端 做 出 的 更 改 触发 服 
求 发 生 时 可 见 务 器 主动 更 新 所 有 的 客户 端 








图 1-5 ”传统 的 客户 端 - 服 务 器 架构 和 分 布 式 应 用 程序 平台 的 比较 
把 应 用 移动 到 浏览 器 后 , 所 有 的 客户 端 基本 上 就 变 成 了 应 用 程序 集群 的 节点 。 这 引入 了 新 的 


挑战 ,也 就 是 在 分 布 式 服务 如 集群 中 所 见 过 的 问题 ,最 重要 的 是 同步 所 有 市 点 之 间 的 数据 。Meteor 
通过 它 与 生 俱 来 的 响应 式 支 持 来 解决 这 个 问题 。 


1.1.5 ”响应 式 编程 


用 传统 的 编程 范式 创建 的 应 用 程序 很 像 你 计划 好 的 一 个 便 儒 "。 无 论 发 生 什 么 ， 它 会 一 直 按 
照 给 定 的 方式 运行 。 作 为 它 的 创造 者 , 你 必须 努力 定义 命令 的 每 一 个 步骤 。 例 如 , 在 应 用 程序 中 ， 
你 必须 定义 监听 下 拉 元 素 的 变化 ,以 及 该 元 素 在 选择 新 值 时 采取 什么 行动 。 此 外 , 还 需要 定义 应 


























@ 在 神话 故事 中 ， 人 狗 儒 通 常 是 由 粘土 制 成 的 ， 它 神奇 地 拥有 了 生命 ， 并 且 分 毫 不 差 地 执行 主人 的 愿望 。 如 果 你 是 奇 
幻 小 说 迷 ， 特 里 ， 普 拉 切 特 的 Feer of Clay 算 是 不 错 的 介绍 。 
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用 程序 在 各 种 情况 下 应 该 怎么 做 ， 比 如 一 个 用 户 删 除了 相关 的 条 目 ， 而 与 此 同时 ， 另 一 个 用 户 却 
想 要 显示 它 的 内 容 。 换 句 话 说， 传统 的 编程 很 难 对 世界 作出 反应 ， 它 只 是 遵循 编码 中 的 命令 。 

现实 世界 的 情况 略 有 不 同 。 特 别 是 在 Web 上 ， 有 很 多 事件 发 生 ， 使 用 环境 越 复杂 ， 就 越 难 预 
见 事件 的 发 生 顺 序 。 

桌面 环境 中 的 响应 性 已 是 规范 。 当 你 使 用 微软 的 Excel 电 子 表格 时 ， 修 改 一 个 单元 格 的 值 ， 
所 有 其 他 依赖 于 它 的 值 会 自动 重新 计算 。 图 表 也 会 因此 调整 , 而 不 需要 单 击 刷新 按钮 。 一 个 事件 ， 
如 改变 单元 格 ， 会 在 表 中 的 相关 部 分 引发 响应 。 所 有 单元 格 都 是 响应 式 的 。 

为 了 演示 响应 式 编程 与 过 程式 编程 的 不 同 ， 让 我 们 看 一 个 简单 的 例子 。 我 们 有 两 个 变量 : a 
和 b。 我 们 把 a 和 b 相 加 的 结果 存储 在 一 个 叫 作 c 的 变量 中 ， 用 过 程式 方式 来 做 这 件 事 。 如 下 所 示 : 


a 2 
B 0 
C=a+b; 


c 的 值 现在 是 7。 如 果 我 们 把 a 的 值 改 为 5 会 发 生 什么 呢 ?” 除 非 我 们 显 式 调用 加 法 ,否则 c 的 值 
不 会 更 改 。 因此, 开发 人 员 需 要 开发 一 个 检查 方法 , 以 观察 a 或 b 是 否 改变 了 。 在 响应 式 的 方法 中 ， 
值 c 将 自动 被 设置 为 10， 因 为 底层 引擎 会 观察 相关 的 变化 。 没 有 必要 定期 检查 a、b 有 无 改变 或 明 
确 启 动 重新 计算 。 开 发 者 重点 关注 的 是 系统 应 该 做 什么 ， 而 不 是 怎样 去 做 。 

在 Web 环 境 中 ,Excel 的 效果 可 以 通过 几 种 方式 实现 。 通 过 轮 询 和 比较 , 你 可 以 每 两 秒 检查 一 
次 数据 是 否 有 变化 。 在 很 多 用 户 参 与 但 变化 不 多 的 场景 中 ， 这 给 所 有 涉及 的 组 件 带 来 很 多 压力 ， 
是 非常 低 效 的 。 而 增加 轮 询 间隔 会 使 用 户 界面 响应 缓慢 。 另 一 种 方法 是 监视 所 有 可 能 的 事件 ,并 
为 事件 定义 行为 ， 编 写 大 量 的 代码 来 模拟 桌面 行为 。 使 用 这 种 方式 ， 当 你 需要 更 新 DOM 中 的 各 
种 元 素 时 ， 即 使 每 个 事件 发 生 时 只 有 少数 的 更 新 操作 , 项 目 维护 也 将 变 成 一 场 璐 梦 。 而 响应 式 环 
境 提 供 了 第 三 种 选择 ， 它 提供 了 低 延 迟 的 用 户 界面 ， 而 且 代 码 简洁 、 可 维护 性 好 。 

响应 式 系统 需要 对 事件 、 加 载 、 错 误 和 用 户 做 出 反应 "。 为 此 ,它们 必须 是 非 阻 塞 和 异步 的 。 
还 记得 我 们 谈 过 的 全 栈 式 JavaScript 吗 ? 你 会 发 现 响应 式 和 JavaScript 简 直 是 天 作 之 合 。 而 且 ， 我 
们 还 讨论 过 Meteor 应 用 程序 的 分 布 式 运 行 ， 服 务 器 并 不 是 负责 创建 用 户 视图 的 唯一 实例 。 负 载 仍 
然 可 以 跨越 多 个 服务 器 进行 部 署 , 但 它 也 可 以 在 每 个 客户 端 上 进行 扩展 。 即 使 这 些 客户 端 中 有 一 
个 失败 ， 它 也 不 会 影响 整个 应 用 程序 。 

虽然 你 仍然 可 以 建立 一 个 不 是 最 优 的 系统 , 在 其 中 不 考虑 响应 式 系统 原则 , 但 响应 性 已 内 建 
在 Meteor 系 统 的 核心 。 你 无 需 担心 要 去 学 习 一 种 新 的 编程 风格 , 可 以 继续 使 用 你 习惯 的 同步 风格 。 
在 很 多 情况 下 ，Meteor 会 自动 使 用 响应 式 功能 ， 而 你 甚至 不 会 注意 到 它 。 

所 有 组 件 ， 从 数据 库 到 客户 端 界面 ,都 是 响应 式 的 。 这 意味 着 所 有 数据 变化 在 客户 端 之 间 是 
实时 同步 的 。 你 不 需 写 任何 Ajax 程序 或 代码 向 用 户 推送 更 新 , 因为 这 个 功能 直接 内 置 在 Meteor 中 。 
此 外 ， 写 大 部 分 的 胶水 代码 以 集成 不 同 组 件 的 需求 被 有 效 消除 ， 从 而 极 大 缩短 了 开发 时 间 。 

响应 式 编程 当然 不 是 对 每 一 个 场景 来 说 都 最 好 ， 但 是 它 非常 适合 Web 应 用 程序 的 工作 方式 ， 
因为 在 大 多 数 情况 下 我 们 需要 捕捉 事件 并 进行 操作 。 除 了 用 户 体验 , 它 可 以 帮助 提高 应 用 的 质量 
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Q@ 响应 式 宣言 定义 了 响应 式 系 统 应 该 如 何 设 计 以 及 在 生产 环境 中 应 该 如 何 表 现 ， 参 见 www.reactivemanifesto.org。 
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和 透明 度 ， 缩 短 编程 时 间 ， 减 少 维护 。 


1.2 ” Meteor 的 工作 原理 


一 旦 部 署 在 服务 器 上 , 就 很 难 把 Meteor 应 用 和 其 他 基于 Node.js 的 项 目 区 分 开 。 当 你 仔细 观察 
Meteor 如 何 增强 开发 过 程 的 时 候 ， 这 个 平台 的 真正 力量 就 会 展现 。CLI 工 具 和 软件 包 集 合 使 开发 
者 快速 实现 结果 , 然后 专注 于 在 程序 中 添加 功能 。 基础 设施 问题 ， 如 数据 库 和 浏览 器 之 间 的 数据 
交换 ， 或 整合 外 部 网 站 的 OAuth 用 户 认证 ， 都 可 以 通过 添加 包 来 解决 。 

1-6 显 示 了 Meteor 应 用 的 结构 。 开 发 者 定义 业务 逻辑 ， 包 括 代码 、 模 板 、 风 格 和 图 像 文件 
等 资源 。Meteor 可 以 通过 npm 安 装 Node.js 的 包 ， 从 而 利用 Node.js 生 态 系统 的 外 部 力量 ， 也 可 以 通 
过 Cordova 来 开发 移动 应 用 。 此 外 ， 它 还 定义 了 它 自 己 的 包 格 式 Isopack。 


所 有 部 署 目 标 使 用 同一 份 代码 





浏览 器 


cordova 相 机 插件 
cordova 电 池 插 件 














Isobuild 服务 器 
图 1-6 ”应 用 程序 包含 业务 逻辑 和 各 种 包 ， 可 使 用 Isobuild 编 译 到 目标 平台 


Isopack 可 以 在 服务 器 和 客户 端的 环境 中 工作 ， 可 以 包含 模板 和 图 像 。 它 们 甚至 可 以 扩展 
Isobuild， 而 Isobuild 的 构建 过 程 为 所 有 目标 平台 输出 可 部 署 的 代码 。Isobuild 和 Isopack 是 Meteor 的 
核心 组 成 部 分 。 

Meteor 应 用 通过 HTTP 和 WebSockets 进 行 数据 交流 ( 参见 图 1-7 )。 初始 页 面 请 求 和 所 有 静态 文 
件 ， 如 图 像 、 字 体 、 样 式 和 JavaScript 文 件 ， 通 过 HTTP 传 输 。 运 行 在 客户 端 和 服务 器 端的 应 用 程 
序 依靠 DDP 协 议 交 换 数据 。SockJS 提 供 必 要 的 基础 设施 。 客 户 端 使 用 远程 过 程 调用 方式 调用 服务 
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器 上 的 方法 ,客户 端 通过 网 络 调用 函数 。 服务 器 返回 响应 , 返回 格式 为 JavaScript 对 象 符号 (JSON ) [本 到 

对 象 。 此 外 ， 每 个 客户 端 可 以 订阅 某 些 数据 。Livequery 组 件 负责 通过 DDP 推 送 订阅 数据 的 更 新 。 

响应 式 Tracker 库 观察 这 些 变化 并 通过 Blaze 触 发 UI 层 的 DOM 更 新 。 
通过 HTTP 进 行 初 始 请 求 和 传输 


( 所 有 静态 资源 


、 初始 页 面 请 求 Re 




















































































































静态 资源 HTML、JS、CSS、 
JPG、PNG 等 
应 用 
| 远程 过 程 调用 | 
数据 订阅 i | [reer | 
[Er 
AN 服务 器 客 P 请 / 
客户 端 通过 基于 WebSockets 
Livequery 监 视 更 新 并 推 的 DDP 调 用 服务 器 函数 ， Tracker 通 过 Blaze 触 发 用 
送 数 据 到 所 有 订阅 的 客户 服务 器 返回 的 数据 为 JSON 户 界面 的 响应 性 更 新 
对 象 
图 1-7 服务 器 和 客户 端 之 间 的 通信 








1.2.1 ”核心 项 目 


Meteor 自 带 的 一 些 包 提供 了 基于 Web 的 应 用 的 常用 功能 。CLI 工 具 允 许 你 创建 一 个 新 的 项 目 ， 
并 通过 单个 命令 添加 或 删除 包 。 新 建 的 项 目 中 已 经 包含 了 所 有 的 核心 包 。 

1. Blaze 

Blaze 是 一 种 响应 式 UI 库 ， 它 的 一 部 分 是 模板 语言 Spacebars。 因 为 开发 者 通常 (只 ) 通过 模 
板 语言 与 前 端 库 交互 ， 并 且 Spacebars 相 对 容易 使 用 ( 和 其 他 模板 语言 相 比 )， 所 以 Blaze 比 React、 
Angular 或 Ember 使 用 起 来 更 简单 。 

官方 文件 将 Blaze 描 述 为 一 个 “响应 式 jQuery”, 一 个 强大 的 更 新 DOM 的 库 。 但 它 不 使 用 jQuery 
的 命令 式 风格 (“查找 元 素 #user-1ist 并 添加 一 个 新 的 1i 节 点 ”)， 而 采用 了 声明 式 方法 (“使 用 
模板 users 绘 制 该 列表 中 数据 库 里 的 所 有 用 户 名 ”)。 当 内 容 发 生变 化 时 , Blaze 只 更 新 模板 内 的 一 
小 部 分 ， 而 不 是 整个 页 面 。 它 也 能 和 其 他 的 UI 库 很 好 地 协作 ， 如 jQuery UI， 甚 至 是 Angular。 

2. Tracker 

Tracker 提 供 函 数 响应 式 编程 (functionalreactive programming，FRP ) 的 基本 功能 。 在 其 核心 ， 
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Tracker 是 一 个 简单 的 约定 ， 即 允许 响应 数据 源 〈 比如 来 自 数据 库 的 数据 ) 连接 到 数据 的 消费 者 。 
看 1.1.5 节 的 这 个 代码 : 


总 S 可 -本 而 


a 和 pb 都 是 响应 数据 源 ，c 是 消费 者 。 改 变 a 或 b 会 触发 c 的 重新 计算 。Tracker 处 理 响应 的 方式 
是 ,建立 一 个 响应 上 下 文 ， 其 中 记录 了 数据 和 函数 之 间 的 依赖 关系 ， 当 数据 变化 时 使 该 响应 上 下 
文 无 效 ， 然 后 重新 运行 相关 的 函数 。 

3. DDP 

访问 Web 应 用 程序 通常 是 通过 HTTP 实 现 的 ， 从 定义 上 说 ，HTTP 是 一 个 文档 交换 协议 。 虽 然 
它 有 用 于 文档 传输 的 优势 ， 但 在 仅 传递 数据 时 ， 它 也 有 些 缺 点 ， 所 以 Meteor 采 用 了 基于 JSON 的 
专用 协议 ， 即 DDP。DDP 是 一 种 来 通过 WebSockets 来 双向 传递 数据 的 标准 方式 ， 没 有 封装 文档 的 
开销 。 该 协议 是 所 有 响应 式 功能 的 基础 ， 是 Meteor 的 核心 要 素 之 一 。 

DDP 是 一 种 标准 的 方法 , 用 以 解决 客户 端 JavaScript 开 发 者 面临 的 最 大 问题 : 查询 服务 器 端的 
数据 库 、 将 结果 发 送 到 客户 端 以 及 把 数据 库 中 的 任何 更 新 扒 : 送 到 客户 端 , DDP 在 最 主要 的 几 大 语 
言 中 都 有 实现 ， 如 Java、Python 或 者 Objective-C。 这 意味 着 你 可 以 只 使 用 Meteor 作 为 一 个 应 用 程 
序 的 前 端 组 件 ， 而 使 用 Java 作 为 后 端 ， 二 者 通过 DDP 进 行 交流 。 

4. Livequery 

在 像 Meteor 这 样 的 分 布 式 环境 中 , 需要 一 种 方式 来 将 由 一 个 客户 端 发 起 的 变化 推送 到 所 有 其 
他 的 客户 端 ， 而 不 需要 刷新 按钮 。Livequery 检 测 数据 库 中 的 变化 , 推送 更 新 到 所 有 正在 查看 受 影 
响 数据 的 客户 。Meteor 1.0 和 MongoDB 是 紧密 集成 的 ， 但 其 他 数据 库 的 支持 已 经 在 计划 中 。 

5. 全 栈 数 据 库 驱动 

在 客户 端 上 执行 的 许多 任务 依赖 于 数据 库 的 功能 ， 如 过 滤 和 排序 。Meteor 利 用 了 无 颖 的 数据 
库 无 处 不 在 ( database everywhere ) 原理 。 这 意味 着 作为 一 个 开发 人 员 ， 你 可 以 在 该 技术 栈 的 任 
何 地 方 重用 你 的 代码 。 

Meteor 带 有 一 个 微型 数据 库 , 它 在 浏览 器 中 模拟 实际 的 数据 库 。MongoDB 的 微型 数据 库 被 称 
为 Minimongo, 它 是 一 个 在 内 存 中 的 、 非 持久 性 实现 的 纯 JavaScript MongoDB。 它 不 依赖 于 HTML5 
的 本 地 存储 ， 因 为 它 只 存在 于 浏览 器 的 内 存 中 。 

浏览 器 中 的 数据 库 镜 像 是 实际 服务 器 数据 的 一 个 子 集 , 用 来 模拟 如 插入 这 样 的 动作 。 它 也 用 

作 查 询 的 缓存 ， 因 此 客户 端 可 以 直接 访问 可 用 的 数据 ， 而 无 需 任何 联网 动作 。Minimongo 和 
MongoDB 的 连接 也 是 响应 式 的 ， 它 们 的 数据 会 自动 保持 同步 。 

延迟 是 桌面 应 用 程序 和 Web 应 用 之 间 的 一 个 关键 区 分 因素 。 没 有 人 喜欢 等 待 ， 所 以 Meteor 在 
客户 端 使 用 预 取 和 模型 模拟 方法 ， 使 你 的 应 用 程序 看 起 来 像 有 一 个 零 延 迟 的 数据 库 连 接 。 本 地 
Minimongo 实 例 用 来 模拟 任何 数据 库 操 作 ， 然 后 再 发 送 请 求 到 服务 器 。 

客户 端 不 需要 等 待 远程 数据 库 完 成 写 人 , 但 应 用 程序 假定 它 最 终 会 成 功 , 这 使 得 绝 大 多 数 的 
用 例 都 要 快 很 多 。 在 向 服务 器 发 送 写 入 操作 时 出 现 问题 的 情况 下 ,客户 端 需 要 优雅 地 回 深 并 显示 
一 个 错误 信息 。 
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图 1-8 中 是 一 个 典型 的 事件 流 。 一 旦 用 户 发 表 评论 ， 它 会 验证 ， 然 后 立即 存储 在 浏览 器 中 的 
Minimongo 数 据 库 。 除 非 验证 失败 ， 和 否则 此 操作 将 成 功 ， 用 户 的 视图 将 立即 更 新 。 此 时 没有 任何 
网 络 流量 , 所 有 的 动作 都 发 生 在 内 存 中 , 用 户 将 体验 没有 延迟 。 但 在 后 台 , 这 一 动作 仍 在 进行 中 。 


潜在 的 不 安全 内 容 
被 发 送 到 服务 器 











6. 验证 数据 5 2. 验证 数据 


5. 调 用 方法 来 ” 
存储 评论 








































8. 确认 成 功 








图 1-8 使 用 延迟 补偿 的 数据 流 

















评论 被 发 送 到 服务 器 端 , 在 那里 再 次 验证 , 然后 被 存储 在 数据 库 中 。 此 时 一 个 通知 消息 会 发 
送 到 浏览 器 , 指示 存储 操作 是 否 成 功 , 在 这 一 点 上 , 至 少 有 一 个 完整 的 服务 器 来 回 与 一 些 磁 盘 IO 
发 生 , 但 这 些 都 没有 影响 用 户 体验 。 从 用 户 的 角度 来 看 ,视图 的 更 新 没有 延迟 ， 因 为 第 四 步 作为 
延迟 补偿 已 经 处 理 了 所 有 更 新 。 最 终 ， 这 一 评论 也 被 发 布 到 所 有 其 他 客户 端 。 

6. 额外 的 包 

除了 核心 包 以 外 , 还 有 更 多 的 软件 包 可 以 作为 Meteor 的 一 部 分 ， 这 些 包 由 开发 社区 提供 。 其 
中 包括 轻松 整合 用 户 通过 Twitter、GitHub 和 其 他 OAuth 认 证 的 功能 。 




















1.2.2 lsobuild 和 CLI 工具 


在 电脑 上 安装 Meteor 后 ， 在 命令 行 中 键 人 meteor 就 进入 了 CLI 工 具 。 这 是 一 个 可 以 和 make 
或 grunt 相 媲美 的 构建 工具 ， 也 是 一 个 类 似 apt 或 npm 的 包 管理 工具 。 它 使 你 能 够 管理 应 用 程序 
相关 的 所 有 任务 : 

口 创建 新 的 应 用 ; 
口 以 包 的 形式 添加 和 删除 功能 ; 
口 编译 和 精简 脚本 和 样式 ; 

口 运行 、 重 置 和 监视 应 用 ; 

口 访问 MongoDB shell; 

口 为 部 署 应 用 程序 做 准备 ; 
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口 部 署 应 用 到 meteorcom。 

创建 新 项 目 是 个 单一 的 命令 , 它 为 一 个 简单 的 应 用 创建 所 有 必要 的 文件 和 文件 夹 结构 。 第 二 
个 命令 将 启动 一 个 完整 的 开发 协议 栈 ， 包 括 一 个 Nodejs 服 务 器 和 一 个 MongoDB 实 例 ， 建 立 一 个 
完整 的 开发 环境 。 任 何 文件 的 更 改 都 会 被 监视 并 直接 发 送 给 客户 端 , 文件 改动 以 热 代 码 的 形式 推 
送 ， 这 样 你 就 可 以 完全 专注 于 编写 代码 而 不 是 启动 和 重启 服务 器 。 

当 开 始 一 个 开发 实例 或 准备 生产 时 ，Meteor 收 集 所 有 的 源 文 件 、 编 译 并 精简 代码 和 样式 、 创 
建 源 映射 、 处 理 所 有 软件 包 的 依赖 关系 。 这 样 ， 它 组 合 了 grunt 和 npm 功 能 。 

如 果 你 使 用 LESS 而 不 是 普通 的 CSS， 就 没有 必要 定义 处 理 链 ， 只 需要 添加 相应 的 Isopack。 
所 有 的 *.less 文 件 将 自动 被 Meteor 处 理 : 


$ meteor add less 


添加 coffeescript 包 可 把 CoffeeScript 编 译 成 JavaScript。 


1.2.3 ”客户 端 代 码 和 服务 器 端 代码 


当 开 始 用 Meteor 进 行 开 发 时 ,你 就 会 发 现 , 知道 哪些 代码 在 哪个 环境 中 运行 是 开发 应 用 程序 
必 不 可 少 的 。 理 论 上 所 有 的 代码 都 可 以 在 栈 的 任何 地 方 运行 ， 但 还 是 有 些 限制 的 。API 密 钥 绝 不 
能 发 送 到 客户 端 , 处 理 鼠 标 单 击 事件 的 映射 在 服务 器 上 是 没 用 的 。 要 让 Meteor 知 道 在 哪里 执行 特 
定 的 代码 ， 可 以 在 专用 文件 夹 中 组 织 文件 ， 或 者 使 用 检查 来 验证 它们 正在 运行 的 上 下 文 。 

举 一 个 例子 ,所 有 处 理 鼠 标 事件 的 代码 都 可 以 放 在 名 为 client 的 文件 夹 里 ,另外 ,所 有 的 HTML 
和 CSS 文 件 在 服务 器 端 是 不 需要 的 ， 因 此 它们 也 会 在 client 文 件 夹 中 。 访 问 邮 件 服务 器 的 密码 或 
API 密 钥 必 须 永 远 不 会 被 发 送 给 客户 端 ， 它 们 将 被 保存 在 服务 器 上 ( 参见 图 1-9 )。 








































































































{v Bl client 
: 大 | events.js | 
@| styles.css Ls 发 送 到 浏览 器 
®| views.html | 
| lib 


common.js 
者] validations.js 


| server 本 在 服务 器 上 处 理 


寺 ] mails.js 























图 1-9 一 个 简单 应 用 程序 的 文件 结构 


server 文 件 夹 中 的 所 有 内 容 永 远 不 会 发 送 给 客户 端 。 为 避免 见 余 ， 共 享 代码 可 以 保存 在 共享 
文件 来， 如 lib， 它 在 这 两 种 情况 下 均 可 用 。 你 很 容易 在 服务 器 端 使 用 jQuery 这 样 的 前 端 库 。 
当 涉 及 输入 验证 时 , 在 两 个 实例 之 间 共 享 代码 特别 有 用 。 用 来 验证 用 户 是 否 正确 输入 信用 卡 
号 码 的 方法 ,可 用 于 在 浏览 器 中 显示 错误 消息 ,也 可 用 在 服务 器 端 ， 防止 向 服务 器 上 的 数据 库 插 
入 错误 的 数据 。 如 果 没 有 Meteor, 你 需要 用 JavaScript 定 义 一 个 方法 在 浏览 器 上 进行 验证 , 还 需要 
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在 服务 器 上 下 文中 定义 另 一 个 验证 方法 , 因为 一 切 来 自 浏览 器 的 数据 在 进行 处 理 之 前 都 必须 进行 
安全 验证 ， 以 此 来 建立 一 定 程度 的 安全 性 。 如 果 你 的 后 端 是 用 Ruby、PHP 或 Java 语 言 开 发 的 ， 这 
不 仅 有 宛 余 的 代码 ,而且 同样 的 任务 需要 做 两 次 -即使 在 服务 器 端 使 用 基于 JavaScript 的 其 他 框架 ， 
也 需要 分 别 复制 和 粘贴 验证 部 分 的 代码 到 服务 器 端的 文件 和 客户 端的 文件 。Meteor 框 架 则 不 需要 
这 样 做 ， 它 在 两 端 处 理 同一 个 文件 。 

在 初始 页 面 加 载 时 ， 所 有 JavaScript、 样 式 以 及 图 像 或 字体 等 静态 资源 被 传送 到 客户 端 "。 如 
图 1-10 所 示 ， 所 有 文件 对 服务 器 而 言 都 可 以 使 用 ,但 不 是 所 有 文件 都 会 作为 应 用 程序 的 一 部 分 来 
执行 。 类似 地 , 不 是 所 有 的 文件 都 会 被 发 送 到 客户 端 , 所 以 开发 人 员 可 以 更 好 地 控制 哪些 代码 在 
哪个 环境 中 运行 。 文 件 传 输 通过 HTTP 实 现 ， 它 也 为 那些 不 支持 WebSockets 的 浏览 器 提供 了 后 备 
方案 。 初 始 页 面 加 载 后 ， 只 有 数据 通过 DDP 进 行 交 换 。 

所 有 应 用 程序 文件 都 存储 在 服 



































务 器 上 ， 但 不 是 所 有 的 文件 都 ee 在 应 用 上 下 文中 ， 只 有 客 
被 作为 应 用 程序 的 一 部 分 执行 传输 文件 户 端 文件 被 传输 和 执行 
了 Bl client 


志 events.js ! 

一 ! ! 

© styles.css | ! 了 Bl client 

| views.html ! 1 壳 ] events.js 
lb | ! | 

| | | styles.css 

寺 | common.js ! ! | views.html 

= 四 1 1 od 

validations.js | | .lb 


BM server 大 | common.js 


二 | | 
问 mails.js | ! 寺 ] validations.js 





图 1-10 ”服务 器 和 客户 端 之 间 通 过 HTTP 和 DDP 进 行 数据 交换 





1.3 ”优势 和 劣势 

和 所 有 工具 一 样 ， 对 于 有 些 情形 ，Meteor 是 非常 适合 的 框架 , 但 总 有 一 些 场景 , 使 用 它 可 能 
是 一 个 糟糕 的 选择 。 一 般 而 言 ,任何 基于 分 布 式 应 用 平台 原则 的 应 用 都 将 大 大 受益 于 它 ， 而 对 一 
个 相对 更 静态 的 网 站 而 言 ， 你 不 会 因 使 用 Meteor 而 获得 很 多 好 处 。 




















GD 从 技术 上 讲 ， 所 有 的 JavaScript 文 件 会 合并 成 一 个 appjjs 文 件 ， 但 为 了 更 好 地 跟踪 ， 多 个 文件 可 说 明 信 息 的 流动 。 
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1.3.1 使 用 Meteor 的 好 处 


Meteor 平 台 提供 了 所 有 的 工具 ， 用 以 构建 不 同 平 台 上 的 应 用 程序 ， 如 基于 Web 或 者 移动 设备 
的 应 用 程序 。 这 是 一 个 一 站 式 的 开发 平台 , 相 比 大 多 数 的 其 他 框架 , 它 可 以 让 开发 人 员 更 简单 地 
开始 。Meteor 的 主要 优势 是 整个 技术 栈 通 用 的 单一 语言 、 内 置 的 响应 式 支 持 ， 以 及 用 以 扩展 现 有 
功能 的 鞍 勃 发 展 的 生态 系统 。 总 之 ， 这 意味 着 开发 速度 的 提升 。 

在 整个 应 用 栈 中 只 有 一 种 语言 、 一 个 专 为 数据 交换 设计 的 协议 、 简 单 统一 的 API， 不 需要 使 
用 额外 的 JavaScript 框 架 ， 比 如 需要 和 复杂 REST 后 端 进行 交流 的 AngularJS 或 Backbone 框 架 。 这 使 
得 Meteor 非 常 适合 需要 快速 构建 的 项 目 ， 同 时 它 还 可 满足 用 户 的 高 期 望 。 

1. 容易 学 习 

快速 实现 可 视 化 的 结果 是 学 习 的 最 好 激励 手段 之 一 。Meteor 充 分 利用 了 MEAN 栈 的 力量 ， 
MEAN 非 常 强大 ， 但 是 太 复 杂 ， 难 于 学 习 。 为 了 提高 开发 人 员 的 生产 力 ，Meteor 使 用 了 一 套 通用 
的 JavaScript API 来 暴露 MEAN 栈 的 功能 。 新 开发 人 员 不 必 对 松散 耦合 的 前 端 库 和 后 端 框架 进行 深 
入 地 研究 ， 就 可 以 实现 一 些 应 用 。 对 JavaScript 有 些 基 本 的 了 解 就 足够 开始 了 。 

Meteor 的 通用 API 也 使 得 它 更 容易 与 Node.js 的 事件 循环 一 起 工作 ， 它 允许 开发 人 员 编 写 同步 
代码 而 不 用 担心 般 套 回调 结构 。 现 有 的 知识 可 以 重用 ， 因 为 如 jQuery 或 Underscore 这 样 熟悉 的 库 
就 是 该 栈 的 一 部 分 。 

2. 客户 端 应 用 

随 着 客户 端 越 来 越 强大 , 大 部 分 应 用 可 以 在 客户 端 上 运行 ， 而 不 是 服务 器 上 。 这 给 我 们 带 来 
了 两 个 主要 好 处 ， 它 们 对 Meteor 而 言 也 是 有 效 的 : 

口 当 客 户 端 执 行 某 些 处 理 时 ， 服 务 器 的 负载 会 较 小 ; 
口 在 用 户 界 面 中 有 更 好 的 响应 性 。 

要 把 浏览 器 有 效 地 升级 成 智能 客户 端 ， 很 重要 的 一 件 事情 是 提供 一 个 双向 通信 的 基础 设施 ， 
使 服务 器 可 以 向 客户 端 推送 更 新 。 有 了 DDP，Meteor 不 仅 提 供 了 传输 层 ， 而 且 提 供 了 一 个 双向 沟 
通 的 完整 解决 方案 。 这 些 无 状态 的 连接 是 该 平台 的 一 个 核心 功能 , 开发 者 可 以 利用 它们 而 不 必 担 
心 消 息 的 格式 。 

3. 使 用 响应 式 编 程 的 即时 更 新 

一 个 应 用 程序 的 大 部 分 代码 是 处 理事 件 。 用 户 单 击 某 个 元 素 可 能 会 触发 一 个 函数 来 更 新 数据 
库 中 的 文档 ,并 更 新 当前 视图 。 当 使 用 响应 式 编程 时 ,你 需要 为 处 理事 件 写 的 代码 会 减少 。 由 数 
百 个 事件 构成 的 大 规模 合作 变 得 更 加 容易 管理 。 因 为 这 个 原因 ，Meteor 特 别 适 合 实 时 聊天 和 网 络 
游戏 ， 其 至 是 对 物 联网 的 支持 。 

4. 高 代码 重用 

Meteor 提 供 古 老 的 Java 承 诺 : 一 次 编写 ， 到 处 运行 。 由 于 Meteor 的 同 构 性 质 ， 同 样 的 代码 可 
以 在 浏览 器 中 、 服 务 器 上 甚至 是 移动 设备 上 运行 。 

例如 ， 在 REST 架 构 中 ， 后 端 必须 用 SQL 与 数据 库 交 流 ， 而 客户 端 硕 望 得 到 的 是 JSON。 利 用 
浏览 器 中 的 微型 数据 库 , 服务 器 可 以 将 少量 的 记录 发 布 到 客户 端 , 这 反 过 来 又 使 得 访问 该 数据 时 
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就 好 像 它们 在 一 个 真实 的 数据 库 中 。 这 让 以 最 小 的 编码 要 求 而 得 到 强大 的 延迟 补偿 成 为 可 能 。 
5. 强大 的 构建 工具 
Meteor 提 供 了 开 箱 即 用 的 CLI 工 具 ， 作 为 一 个 软件 包 管 理 和 构建 管理 工具 ， 它 覆盖 了 整个 构 
建 过 程 ， 从 收集 和 编译 源 文件 到 文件 精简 、 源 映射 、 解 决 依赖 关系 。Isobuild 工 具 可 为 Web 优 化 应 
用 ， 或 者 把 应 用 封装 为 Android 或 iOS 应 用 程序 。 


1.3.2 ”使 用 Meteor 时 的 挑战 


虽然 你 可 以 使 用 Meteor 来 构建 任何 类 型 的 网 站 ,但 在 某 些 情况 下 ， 最 好 采用 其 他 的 框架 。 鉴 
于 Meteor 相 对 较 小 的 年 龄 和 定位 ， 使 用 它 时 你 可 能 会 遇 到 一 些 挑战 。 

1. 计算 密集 的 应 用 

尤其 是 当 你 的 应 用 程序 依赖 于 密集 计算 ， 如 数据 分 析 、 提 取 、 转 换 和 加 载 (ETL ) 工作 时 ， 
Meteor 将 无 法 很 好 地 处 理 这 种 负载 。 本 质 上 ,任何 Node.js 都 是 单线 程 的 ,所 以 很 难 利用 快速 的 多 
处 理 需 能 力 。 在 多 层 的 架构 中 ，Meteor 可 以 用 来 提供 用 户 界面 ， 但 它 不 能 提供 强大 的 计算 能 

要 在 Meteor 应 用 中 提供 更 多 的 计算 能 力 , 可 采用 类 似 其 他 Node.js 应 用 采用 的 方式 : 将 CPU 密 
集 的 任务 委托 给 子 进 程 。 在 用 多 层 架 构 把 数据 处 理 和 用 户 界面 分 离 的 任何 语言 中 , 这 也 是 一 个 适 
用 的 最 佳 实践 。 

2. 成 熟 性 

Meteor 还 比较 年 轻 ， 还 需要 证 明 自 己 在 生产 环境 上 的 伸缩 性 或 搜索 引擎 友好 。 特 别 地 ， 对 应 
用 程序 的 伸缩 性 而 言 ， 需 要 所 涉及 组 件 及 可 能 瓶颈 的 大 量 知识 。 

虽然 Node.js 已 经 证 明了 它 在 大 负载 时 的 可 伸缩 性 , Meteor 仍 然 需要 证 明 它 可 以 处 理 大 规模 的 
部 署 和 高 并 发 的 请 求 。 保 守 的 用 户 可 能 会 认为 ,依靠 一 个 既定 的 基础 是 安全 的 。 但 请 记 住 ， 如 果 
应 用 程序 在 开发 时 没有 考虑 可 扩展 性 和 性 能 的 话 ， 任 何 服务 器 栈 和 框架 都 可 能 会 变 慢 。 

即使 Meteor 社 区 是 友好 和 乐于 助人 的 ， 这 也 没有 办 法 和 PHP 或 Java 可 提供 的 庞大 资源 相 比 。 
关于 托管 选项 也 是 类 似 的 情况 ， 和 PHP 或 者 Python 比 起 来 ， 还 没有 多 少 专门 的 Node.js 或 Meteor 的 
解决 方案 。 如 果 你 计划 在 自己 的 基础 设施 上 托管 自己 的 应 用 程序 ,有 几 个 解决 方案 是 可 以 使 用 的 。 

与 所 有 的 年 轻 项 目 一 样 ， 现 在 Meteor 框 架 本 身 的 可 用 工具 数量 是 相当 有 限 的 。Velocity 是 一 
个 社区 驱动 的 项 目 ， 用 以 创建 测试 框架 , 它 有 活跃 的 开发 者 , 但 现在 还 不 是 Meteor 核 心 项 目的 一 
部 分 。 同 时 ,调试 工具 也 不 如 Java 或 PHP 方 便 。 

3. 没有 关于 结构 的 约定 

Meteor 对 应 用 的 结构 和 代码 没有 什么 约定 。 这 种 自由 是 伟大 的 ,单个 的 开发 人 员 可 以 快速 修 
改 代码 , 但 当 应 用 程序 的 规模 增长 时 ， 它 需要 团队 成 员 之 间 良 好 的 协调 。 使 用 单个 文件 还 是 数 百 
个 文件 夹 和 文件 ， 这 取决 于 开发 人 员 的 偏好 。 有 些 人 可 能 会 拥抱 这 种 自由 ， 而 男 一 些 人 会 发 现 有 
必要 在 开始 编码 之 前 定义 清晰 的 结构 。 

4. 使 用 SQL 和 相关 数据 库 

路 线 图 显示 ， 总 有 一 天 ，Meteor 会 支持 SQL 数据 库 ， 但 目前 唯一 的 官方 支持 数据 库 是 
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MongoDB。 要 使 用 MySQL 或 PostgreSQL 等 数据 库 ， 必 须 使 用 额外 的 社区 包 。 虽 然 一 些 社区 成 员 
通过 SQL 数据 库 支 持 成 功 地 运行 了 应 用 , 但 尚 无 全 栈 的 支持 ， 如 没有 延迟 补偿 和 透明 的 客户 端 到 
服务 器 的 更 新 。 如 果 你 需要 坚实 的 关系 数据 库 和 相关 技术 栈 的 支持 ， 那 么 Meteor 不 适合 你 。 

5. 提供 静态 内 容 

一 些 网 站 像 报纸 和 杂志 一 样 , 严重 依赖 静态 内 容 。 这些 站 点 的 利润 大 部 分 来 自 服务 器 呈现 的 
HTML, 可 以 使 用 先进 的 缓存 机 制 , 为 所 有 用 户 加 快 网 站 访问 。 此 外 , 初始 的 加 载 时 间 也 快 得 多 。 
如 果 初 始 加 载 时 间 对 你 的 应 用 很 重要 , 或 者 它 为 大 量 的 用 户 提 供 相同 的 内 容 , 你 将 无 法 充分 
利用 Meteor 的 所 有 优势 。 事实 上 ,你 需要 研究 它 的 标准 行为 ， 找 到 方法 来 优化 用 例 ， 因 此 你 可 能 
希望 使 用 一 个 更 传统 的 框架 来 构建 网 站 。 




































































do 

















谁 在 使 用 Meteor (知情 者 说 》 

尽管 还 很 年 轻 ， 但 Meteor 已 经 为 许多 成 功 的 项 目 甚 至 整个 公司 提供 了 动力 。 

Adrian Lanning 的 share911.com 是 Meteor 平 台 的 早期 采用 者 之 一 。 在 紧急 情况 下 ,应 用 程序 
使 你 能 够 同时 提醒 和 你 一 起 的 工作 人 员 以 及 公共 安全 人 员 。 选 择 一 项 技术 的 主要 标准 是 速度 ， 
包括 实时 运行 时 间 以 及 开发 时 间 。Adrian 研 究 了 几 个 事件 驱动 技术 : Netty (Java )、Tornado 
(Python ) 和 Node.js。 在 进一步 评估 Tower 和 Derby.js 后 ， 他 决定 使 用 Meteor 开 发 一 个 原型 ， 花 
了 不 到 10 天 的 时 间 。 

“ 令 人 高 兴 的 是 ，Meteor 一 直 是 可 靠 的， 我 们 还 不 需要 做 出 改变 。 我 们 已 经 包括 了 

其 他 技术 ， 但 我 有 信心 ，Meteor 将 在 很 长 一 段 时 间 内 是 我 们 的 核心 Web 层 。 

一 一 Adrian Lanning 
workpop.com 提 供 了 一 个 工作 平台 ， 用 以 雇用 以 小 时 计 薪 的 工人 。 只 用 两 个 人 的 开发 团队 
和 短 短 五 个 月 的 时 间 ,首席 技术 官 Ben Berman 就 作出 了 一 个 现代 解释 一 一 互联 网 上 的 工作 公告 
牌 看 起 来 应 该 是 怎样 的 。 超 过 700 万 美元 的 资金 证 明 , 他 们 决定 使 用 Meteor 是 正确 的 。workpop 
的 哲学 是 跳出 技术 的 障碍 , 关注 于 他 们 的 目标 , 即 让 人 们 找到 工作 。Spring ( Java ) 和 ASPNET 
虽然 很 高 效 ， 但 是 过 于 技术 密集 。 就 连 Rails 也 被 否定 了 ， 因 为 它 鼓 励 构建 RESTful 应 用 。 
“通过 坚持 使 用 熟 悉 的 JavaScript， 以 及 Web 上 最 好 的 响应 式 UI 工 具 包 ，Meteot 为 小 
型 团队 实现 了 快速 迭代 的 承诺 。 
一 一 Ben Berman 
lookback.io 可 以 用 来 记录 移动 用 户 的 体验 ， 通 过 按钮 点 击 来 了 解 人 们 如 何 使 用 你 的 应 用 。 
它 最 初 的 版 本 使 用 Django 开 发 ， 但 开发 组 长 Carl Littke 很 快 就 切换 到 Meteor 平 台 。 要 实现 相同 
的 结果 ， 使 用 Django、Angular 和 相关 的 REST API 显 得 太 复 杂 。 依 靠 Meteor 内 置 的 响应 性 、 数 
据 API 和 登录 功能 会 更 简单 。 开 发 速度 是 选择 Meteor 最 重要 的 考量 。 这 也 弥补 了 Meteor 相 对 年 
轻 的 其 他 领域 。 
“Meteor 开 发 团队 完成 了 杰出 的 工作 ， 他 们 开发 的 框架 解决 了 现代 Web 应 用 程序 开 

发 中 的 一 些 主要 痛 点 。 在 下 一 个 项 目 中 ,我 会 毫 不 狂 隐 地 使 用 Meteor 框 架 。” 

一 一 Carl Littke 
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Sara Hicks 和 Aaron Judd 创 建 了 开源 购物 平台 reactioncommerce.com。 他 们 认为 ，Meteor 
的 事件 驱动 特性 完美 地 适用 于 使 用 动态 营销 、 实 时 促销 和 实时 定价 以 提高 销量 。 在 Web 和 移 
动 设 备 上 使 用 单一 的 代码 库 是 个 很 大 的 优势 。Meteor 并 不 是 Reaction Commerce 平 台所 用 的 唯 
一 技术 ,但 它 构成 了 该 平台 的 基础 。 由 于 可 通过 npm 安 装 所 有 的 Node.js 包 ， 额 外 的 库 可 添加 
到 项 目 中 。 
“ 较 慢 的 响应 速度 会 让 零售 商 流 失 13% 的 销售 额 。 由 于 Meteor 的 延迟 补偿 ， 屏 幕 会 
立刻 重 绘 。 这 带 来 了 愉快 的 购物 体验 和 更 漂亮 的 销售 数字 。 





一 一 Sara Hicks 

Sacha Greif 创 建 了 流行 的 黑客 新 闻 克 隆 网 站 Telescope。 为 寻找 合适 的 技术 栈 ， 他 把 自己 的 
选择 圈定 在 Rails 和 Node.js。 关 于 Rails， 他 担心 管理 大 量 移动 部 件 的 问题 ， 因 为 管理 这 些 部 件 
需要 数 百 个 文件 和 gem。 作为 一 个 设计 师 , 他 已 经 熟悉 JavaScript。 2012 年 , 他 就 决定 使 用 Meteor 
框架 ， 尽 管 当时 它 的 功能 集 还 很 有 限 。 如 今 ，Telescope 已 经 开始 为 一 些 网 站 提供 支持 ， 比 如 
craterio〈 关 于 Meteor 框 架 的 新 闻 ) 和 bootstrappers.io( bootstrap 的 创业 社区 )。 

“真正 吸引 我 的 是 它 的 一 站 式 解决 方案 ， 在 别 的 框架 中 需要 将 多 个 解决 方案 拼接 在 
一 起 ， 而 所 有 这 些 东 西 在 Meteor 框 架 中 则 是 开 箱 即 用 的 。” 





Sacha Greif 
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我 们 已 经 讨论 了 很 多 理论 , 现在 是 时 候 看 看 代码 了 。 在 继续 之 前 , 确保 你 的 机 器 上 已 经 安装 
了 Meteor。 安 装 过 程 可 参考 附录 A。 

因为 Meteor 也 是 一 个 CLI 工 具 ， 所 以 我 们 需要 在 shell 环 境 中 进行 应 用 程序 的 初始 设置 。 这 使 
得 我 们 能 够 安装 框架 ， 创 建新 的 应 用 程序 。 本 节 中 的 所 有 步骤 都 将 在 终端 内 进行 。 




















1.4.1 创建 新 项 目 


Meteor 安 装 好 后 ， 用 CLI 工 具 来 创建 新 项 目 。 进 入 到 你 要 建立 应 用 程序 的 文件 夹 ， 然 后 在 终 
端 键 入 以 下 命令 (参见 图 1-11 ): 
$ meteor create helloWorld 
Meteor 会 自动 创建 一 个 新 的 项 目 文 件 夹 和 三 个 文件 : 
口 helloWorld.css 包 含 所 有 样式 信息 ; 
口 helloWorld.html 包 含 所 有 模板 ; 
口 helloWorld.js 包 含 实际 的 逻辑 。 
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Oe@e@ 天 helloWorld — helloWorld 


MacBook: local stephanS meteor create helloworld 
helloworld: created. 





To run your new app: 

cd helloworld 

meteor 
MacBook: local stephans cd helloworld/ 
MacBook:hellowWorld stephan$ tree -a 


.meteor 
.finished-upgraders 
.gitignore 
,id 


local 

[一 isopacks 

packages 

platforms 

release 

versions 
helloworld.css 
helloworld.html 
helloworld.js 


3 directories，16 files 
MacBook:helloworld stephan$ | 





























图 1-11 用 Meteor CLI 工 具 创建 的 基础 应 用 程序 





说 明 每 个 项 目 都 包含 一 个 不 可 见 的 文件 夹 .meteor ( 如 图 1-11 所 示 )， 这 里 存放 着 一 些 运行 时 文 
件 ， 如 开发 数据 库 、 编 译 过 的 文件 、 有 关 用 到 的 包 的 元 数据 信息 以 及 其 他 自动 生成 的 内 
容 oO 在 进行 开发 时 总 我 们 可 以 忽略 这 个 文件 夹 。 





你 现在 可 以 通过 改变 现 有 文件 的 内 容 来 创建 自己 的 应 用 程序 。 对 于 这 个 项 目 , 这 三 个 文件 就 
足够 了 , 但 是 对 其 他 更 为 复杂 的 项 目 来 说 , 最 好 创建 几 个 文件 夹 并 将 代码 拆 分 成 单独 的 文件 ， 以 
保持 更 好 的 结构 。 我 们 将 在 下 一 章 中 进一步 介绍 如 何 组 织 你 的 项 目 。 


1.4.2 ”启动 应 用 
可 以 通过 Meteor CLI 工 具 用 下 面 的 命令 启动 应 用 : 


$ meteor run 

你 也 可 以 通过 调用 一 个 没有 任何 参数 的 meteor 命 令 启 动 Meteor 服 务 器 ， run 是 默认 行为 。 在 
幕后 ， 它 在 3000 端 口 开 启 Node.js 服 务 器 实例 ， 同 时 开启 监听 3001 端 口 的 MongoDB 服 务 。 

你 可 以 通过 Web 浏 览 器 访问 http:/localhost:3000 来 访问 你 的 应 用 (参见 图 1-12 )。 

如 果 需 要 改变 Meteor 监 听 的 端口 ， 可 指定 meteor 命 令 的 --port 人 参数 。 以 下 命令 使 Meteor 监 
听 端 口 8080: 









































$ meteor run --port 8080 


正如 你 所 看 到 的 ， 应 用 程序 正在 运行 ， 它 有 一 个 按钮 。 如 果 你 单 击 Click Me 按钮 ， 下 面 的 文 
本 将 自动 更 新 ,显示 你 自 加 载 网 页 以 来 单 击 了 它 多 少 次 。 这 是 因为 该 应 用 程序 已 经 包含 一 个 事件 
绑 定 。 让 我 们 仔细 看 一 下 文件 内 容 ， 看 看 这 个 绑 定 如 何 工作 。 
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@@e@ 〈 localhost © © p= 











Welcome to Meteor! 


Click Me 


You've pressed the button 1 times. 
































I 
于 


图 1-12 ”每 个 新 的 Meteor 项 目 都 是 一 个 含有 单个 按钮 的 简 





1.5 剖析 默认 项 目 


在 这 种 状态 下 的 helloWorld 应 用 非常 简单 。 因 为 所 有 的 文件 都 在 这 个 项 目的 根 文件 夹 中 ， 所 
以 它们 都 在 服务 器 上 执行 ， 并 发 送 给 客户 端 。 让 我 们 看 看 每 个 文件 做 了 些 什么 。 





1.5.1 helloWorld.css 


默认 情况 下 ， 该 文件 是 空 的 。 因 为 它 是 一 个 CSS 文 件 ， 所 以 你 可 以 用 它 来 存储 自 定义 的 样式 
信息 。 如 果 把 某 个 东西 放 在 这 个 文件 中 ,该 样式 将 立即 被 应 用 到 应 用 程序 中 。Meteor 自 动 解析 所 
有 以 .css 结 尾 的 文件 并 将 其 发 送 到 客户 端 。 例如 , 试 着 在 其 中 增加 pody { background: red; }， 
保存 文件 ， 你 会 看 到 应 用 程序 的 背景 变 成 了 美丽 的 红色 。 










































































1.5.2 helloWorld.html 


代码 清单 1-1 中 显示 的 文件 包含 我 们 项 目 中 使 用 的 模板 。 模 板 控制 应 用 程序 的 整体 外 观 和 布 
局 。 虽 然 该 文件 的 扩展 名 是 .html， 但 它 里 面 的 代码 不 像 你 期 待 的 那样 是 完全 有 效 的 HTML。 


代码 清单 1-1 helloworld 模 板 


<head> i SS 
<title>helloWorld</title> HTML 头 


</head> 























该 页 面 的 主体 ， 打 印 一 个 标 
<body> 题 ， 并 导入 一 个 名 为 “hello” 
<hil>Welcome to Meteor!</hi> 的 模板 
{{> hello}} 
</body> 


实际 的 “hello” 模 板 
gS ge 起 大 
<template name="hello"> Ma 
<button>Click Me</button> 的 辅助 函数 
<p>You've pressed the button {{counter}} times.</p> 


</template> 


首先 ， 三 个 不 同 的 元 素 出 现在 了 这 里 : 一 个 HTML 头 、 一 个 HTML 主体 和 一 个 名 为 hello 的 
模板 。 正 如 你 所 看 到 的 , 这 里 没有 一 个 有 效 HTML 文档 需要 的 <html> 开 始 标签 。Meteor 会 自动 添 
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加 它 ， 所 以 你 不 必 担 心 。 

这 个 body 只 有 一 个 hi 标题 和 一 个 占 位 符 , 使 用 了 Handlebars 语 法 。 花 括号 说 明 你 正在 处 理 一 
些 动态 的 内 容 。 大 于 号 表示 男 一 个 模板 将 被 注入 到 文档 中 的 这 个 位 置 ,大 于 号 后 面 是 模板 的 名 字 。 
因此 ， 占 位 符 会 在 body 中 插入 名 为 hel1lo 的 模板 : 


{{> hello}} 


服务 器 启动 时 ，Meteor 解 析 所 有 以 .html 为 扩展 名 的 文件 ,并 收集 所 有 的 模板 。 它 识别 和 管理 
所 有 的 引用 与 包含 。 为 使 这 个 工作 正常 进行 ， 每 个 模板 都 要 有 一 个 <template> 的 打开 和 关闭 标 
签 。 需 要 name 属 性 来 引用 模板 。 模 板 的 名 称 是 区 分 大 小 写 的 ， 必 须 始 终 唯 一 。 

你 还 需要 能 够 在 JavaScript 中 引用 模板 , 以 在 某 种 程度 上 扩展 它 的 功能 , 在 下 一 节 中 , 你 会 在 
helloWorld.js 文 件 中 看 到 这 一 点 。 下 次 ,模板 的 名 称 是 用 来 做 连接 的 。 

最 后 ， 你 需要 一 种 方法 来 将 数据 从 JavaScript 代 码 注 入 模板 。 这 是 所 谓 的 辅助 函数 
{{ counter }} 的 目的 。 辅 助 函 数 是 一 个 返回 值 在 模板 中 可 用 的 JavaScript 方 法 。 如 果 查 看 你 的 
浏览 器 ， 你 会 发 现 ，{{ counter }} 中 显示 的 是 你 点 击 的 次 数 。 让 我 们 看 一 下 相应 的 代码 。 


































































































1.5.3 helloWorld.js 
该 项 目的 JavaScript 文 件 包含 Meteor 的 几 个 基本 概念 。 我 们 要 告诉 你 的 第 一 个 片段 如 下 : 


if (Meteor.isClient) { 
A 
} 


if (Meteor.isServer) { 
Hom 
} 


有 两 个 if 语 句 ， 都 和 全 局 的 Meteor 对 象 的 一 个 布尔 变量 有 关 。 请 记 住 ， 所 有 的 代码 都 可 以 
在 客户 端 和 服务 器 端 使 用 ,除非 你 有 什么 限制 。 都 可 用 意味 着 在 两 种 环境 中 都 可 执行 。 但 是 有 时 
候 ， 你 需要 指定 代码 是 应 该 仅 在 服务 需 上 运行 还 是 仪 在 客户 端 上 运行 。 通 过 检查 全 局 Meteor 对 
象 的 这 两 个 属性 ， 你 可 以 知道 你 在 哪里 运行 。 

在 任何 项 目 中 ， 第 一 个 if 语句 的 代码 块 只 在 客户 端 上 下 文中 运行 ， 第 二 个 if 语句 的 代码 块 
只 在 服务 器 端的 上 下 文中 运行 。 

你 应 该 知道 , 这 个 文件 的 所 有 代码 在 服务 器 和 客户 端 都 可 用 。 这 意味 着 你 一 定 不 要 把 安全 相 
关 的 代码 ( 如 私有 接口 密 钥 ) 放 在 一 个 ifE (Meteor.isServer) 块 中 ， 因 为 这 块 代码 可 能 会 直 
接 发 送 到 客户 端 。 任 何人 在 浏览 器 中 打开 源码 视图 , 都 可 以 简单 地 读 取 代码 和 与 安全 相关 的 任何 
信息 ， 而 你 绝对 不 希望 发 生 这 种 情况 。 

当然 有 简单 标准 的 方法 来 处 理 敏感 代码 。 后 面 几 童 会 讨论 如 何 组 织 一 个 项 目 ， 到 时 将 涉 
及 这 个 主题 。 现 在 ,我 们 只 使 用 单个 的 JavaScript 文 件 。 对 于 简单 的 应 用 ,检查 当 前 上 下 文 就 
足够 了 。 
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说 明 当 创 建新 的 项 目 时 ,Meteor 把 开发 人 员 的 生产 力 放 在 第 一 位 。 这 意味 着 将 无 法 确保 将 最 初 
的 项 目 足 够 安全 地 部 署 到 生产 环境 。 在 这 本 书 中 ， 我 们 将 讨论 如 何 为 生产 环境 做 开发 以 
及 如 何 开发 安全 的 应 用 程序 。 


接 下 来 的 代码 看 起 来 像 这 样 : 


if (Meteor.isClient) { 
// 计数 器 从 0 开始 
Session.setDefault ("counter", 0); 


Template.hello.helpers(t{ 
Counter: function (), 芭 
return Session.get ("counter"); 
} 
}):2 
/es 
} 
Pa 
在 这 里 ， 你 看 到 了 两 个 全 局 对 象 的 使 用 : session 和 Template。Session 人 允许 你 在 内 存 中 
存储 键 - 值 对 。Template 对 象 使 你 能 够 从 JavaSeript 文 件 中 访问 HTML 文 件 中 定义 的 所 有 模板 。 
因为 这 两 个 对 象 都 是 在 客户 端 上 可 用 的 ， 所 以 它们 不 能 在 服务 右上 调用 ， 和 否则 将 导致 引用 错误 ， 
这 也 是 为 什么 这 个 代码 被 包 在 isclient 上 下 文中 。 
只 要 session 变 量 没有 声明 ， 它 们 会 保持 在 undefined 状 态 。Session.setDefault () 命 
今 在 session 对 象 内 初始 化 一 个 键 值 对 ， 该 键 值 对 的 键 为 counter， 值 为 0。 
这 上段 代码 可 以 访问 helloWorld.html 中 定义 的 hello 模 板 ， 并 且 用 所 谓 的 模板 辅助 函数 扩展 了 
它 。 这 个 模板 辅助 函数 被 命名 为 counter， 它 的 返回 内 容 是 session 中 键 为 countezr 的 值 , 并 且 
作为 字符 串 类 型 返回 。 现 在 你 明白 为 什么 hello 模 板 与 你 在 浏览 器 中 所 看 到 的 不 同 了 。hel1lo 模 
板 中 的 模板 辅助 函数 {{ counter }} 实 际 上 是 一 个 函数 ， 它 返回 在 浏览 器 中 看 到 的 字符 串 。 
一 方面 ,模板 定义 应 该 呈现 的 HTML; 男 一 方面 ,模板 辅助 函数 扩展 模板 ,使 用 函数 并 用 动 
态 内 容 蔡 换 占 位 符 。 
记得 当 你 单 击 按钮 时 会 发 生 什 么 吗 ? 这 是 事件 绑 定 的 地 方 。 如 果 你 单 击 按钮 ， 一 个 click 事 
件 会 被 触发 。 这 反 过 来 又 给 页 面 上 的 计数 器 加 1。 下 面 的 代码 增加 了 计数 器 的 计数 ， 该 计数 器 存 




























































































储 在 Session 对 象 中 : 只 在 客户 端 处 理 
鼠标 点 LN 让 
if (Meteor.isClient) { 鼠标 点 击 事件 本 

Template.hello.events({ 被 点 击 时 调用 

'click button': function () { 的 函数 

// 按钮 点 击 时 ， 递 增 计 数 器 值 

Session.set ("counter"，Session.get("counter") + 1); 将 Session 变 量 

六 证 的 值 增加 1 





每 个 模板 都 有 events () 函数 ， 你 可 以 在 其 中 定义 特定 模板 的 事件 处 理 。 传 递 给 events () 





24 第 1 章 构建 应 用 程序 的 更 好 方式 























函数 的 对 象 称 为 事件 映射 ， 这 基本 上 是 个 正常 的 键 一 值 JavaScript 对 象 ， 其 中 键 总 是 定义 要 监听 的 
事件 ， 而 值 是 一 个 函数 ， 如 果 监 听 的 事件 发 生 ， 这 个 函数 就 会 被 调用 。 

要 指定 事件 ， 总 是 使 用 字符 串 形 式 的 ' event target' ， 其 中 目标 (target ) 通过 标准 的 CSS 
选择 器 定义 。 你 很 容易 修改 前 面 的 例子 ， 通 过 使 用 CSS 的 class 或 ID 来 进一步 指定 按钮 。 另 外 请 注 
意 , 这 些 事件 只 在 该 模板 的 上 下 文中 被 触发 。 这 意味 着 在 不 同 模板 中 的 任何 输入 , 例如 在 输入 元 
素 上 的 点 击 ， 将 不 会 调用 这 里 的 函数 。 

你 可 以 继续 点 几 下 按钮 ， 你 会 注意 到 浏览 器 如 何 绘制 新 字符 串 。 只 有 占 位 符 被 更 新 了 ， 而 不 
是 整个 页 面 。 
注意 , 这 里 没有 涉及 直接 更 新 模板 的 代码 ， 你 依赖 于 session 的 响应 式 特 征 。 每 当 Session 
对 象 内 部 的 值 发 生变 化 ,模板 辅助 函数 counter 就 会 重新 运行 ,事件 简单 地 改变 数据 源 , 而 Meteor 
会 立即 更 新 所 有 用 到 这 个 值 的 地 方 。 

我 们 要 看 的 最 后 一 个 片段 是 这 样 的 : 

if (Meteor.isServer) { 

Meteor.startup(function () { 
// 应 用 启动 时 在 服务 器 上 运行 的 代码 
9 
} 


正如 注释 中 指出 的 那样 , 你 可 以 定义 一 个 在 应 用 启动 时 运行 的 函数 。 你 也 可 以 在 应 用 启动 时 
多 次 调用 Meteor .startup 孔 数 ， 并 传 给 它 不 同 的 函数 来 执行 不 同 的 功能 。Meteor. startup 
也 可 用 于 客户 端 ,在 客户 端 应 用 启动 时 运行 函数 。 此 示例 应 用 没有 使 用 任何 服务 器 端 代码 ， 因 此 
该 块 和 局 动 函 数 还 是 空 的 。 

现在 你 已 经 看 到 了 helloWorld 示 例 代 码 ， 对 Meteor 的 基本 概念 有 了 深刻 的 理解 ， 接 下 来 你 将 
扩展 这 些 文件 ， 以 开发 自己 的 第 一 个 Meteor 应 用 。 





























































































































1.6 总 结 
在 这 一 章 里 ， 你 学 到 了 如 下 知识 。 
口 Meteor 是 一 个 完整 的 技术 栈 或 同 构 的 JavaScript 平 台 ， 类 似 于 MEAN 栈 。 
口 开发 者 可 以 在 服务 器 、 客 户 端 或 所 有 上 下 文中 运行 相同 的 代码 。 
口 客户 是 应 用 逻辑 的 活动 部 分 ， 这 意味 着 Meteor 应 用 利用 分 布 式 计算 环境 的 力量 。 
口 使 用 称 为 DDP 的 标准 协议 ， 服 务 器 和 客户 端 通过 WebSockets 而 不 是 HTTP 通信 ， 进 行 双向 
消息 交换 。 
口 Meteor 采 用 响应 式 编程 的 原则 ， 以 减少 对 基础 设施 代码 的 需求 。 
口 开发 生产 力 是 由 可 重复 使 用 的 称 为 opack 的 包 保 证 的 ， 这 些 包 被 用 来 提供 通用 的 或 专用 
的 功能 。 
口 单一 的 代码 库 可 提供 基于 浏览 器 的 HTML 应 用 , 或 基于 iOS、Android 移 动 设备 或 Firefox OS 
的 混合 应 用 。 
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本 章 内 容 

口 用 Meteor 建 立 一 个 响应 式 应 用 

口 了 解 Meteor 项 目的 基本 结构 

口 使 用 jQuery UI 启用 拖 放 界面 

口 使 用 Meteor 的 命令 行 工具 部 署 应 用 到 meteorcom 





在 本 章 中 , 你 将 建立 你 的 第 一 个 Meteor 应 用 。 你 可 以 基于 某 个 自 带 的 示例 应 用 来 创建 一 个 新 
项 目 , 但 从 头 开 始 创建 一 个 小 型 响应 式 游 戏 可 以 更 好 地 了 解 各 组 件 是 如 何 一 起 工作 的 。 在 本 章 结 
束 时 , 你 将 使 用 不 到 60 行 的 JavaScript 代 码 以 及 更 少 的 HTML 创 建 了 一 个 游戏 , 该 游戏 将 数据 存储 
到 数据 库 并 实时 更 新 所 有 连接 的 客户 端 。 

你 会 看 到 模板 和 代码 如 何 一 起 工作 , 怎样 在 项 目 中 包含 jQuery UI。 你 还 会 通过 一 个 命令 将 它 
部 署 到 meteorcom 的 基础 设施 上 ， 与 世界 分 享 你 的 应 用 。 


2.1 应 用 概述 


“我 的 冰箱 ”是 一 个 小 型 实时 应 用 程序 ， 它 显示 了 冰箱 内 的 物品 ， 并 允许 你 拖 动物 品 进出 冰 
箱 。 不 同 于 真实 的 冰箱 ,这 个 冰箱 可 以 从 世界 上 任何 地 方 访问 , 并 且 所 有 变化 对 每 个 连接 到 服务 
器 的 客户 端 可 见 。 

虽然 这 个 应 用 程序 只 是 一 个 模拟 器 ， 但 你 可 以 使 用 它 来 记录 家 里 的 冰箱 中 实际 放 了 些 什 么 。 
或 者 ， 如 果 你 是 一 个 硬件 黑客 ， 可 以 把 你 的 冰箱 连接 到 互联 网 上 ， 使 用 Meteor 实 时 显示 冰箱 内 的 
物品 。 这 样 ， 如 果 你 的 朋友 喝 掉 了 冰箱 中 的 最 后 一 瓶 果 汁 ,你 可 以 在 办 公 室 看 到 这 些 ， 然 后 在 回 
家 的 路 上 买点 柳 汁 。 

构建 该 应 用 程序 时 , 我 们 将 保持 事情 的 简单 性 , 仅仅 依靠 每 个 新 建 Meteor 项 目 中 已 经 启用 的 
功能 , 并 将 为 这 个 项 目 添加 代码 、 样 式 、 模 板 和 资产 ( 参见 图 2-1 )。 本 章 不 会 使 用 任何 额外 的 包 。 

首先 ， 使 用 Spacebars 创 建 视 图 ，Spacebars 是 Meteor 的 模板 语言 。 因 为 所 有 物品 都 存储 在 
MongoDB 数 据 库 中 ， 所 以 需要 定义 一 个 数据 库 连 接 。 另 外 ， 你 将 使 用 静态 图 像 来 表示 冰箱 中 的 
每 个 物品 。 最 后 ， 你 将 学 习 如 何 包括 外 部 的 JavaScript 库 ， 使 用 jQuery UI 来 拖 动 物品 进出 冰箱 。 
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浏览 器 














lsobuild 
图 2-1 “我 的 冰箱 ”应 用 只 需要 业务 逻辑 


Meteor 的 响应 性 将 保持 所 有 客户 端的 同步 并 负责 更 新 视图 。 你 只 需要 处 理 实际 的 功能 ,也 就 
是 用 拖 放 来 更 新 数据 库 内 物品 的 位 置 属性 。 在 这 个 应 用 中 ， 将 不 允许 用 户 轻易 添加 额外 的 物品 ， 
而 且 也 不 会 采取 严格 的 安全 措施 。 这 些 主题 将 在 后 面 的 章节 中 讨论 。 这 一 章 结 束 时 , 你 的 冰箱 看 
起 来 会 像 图 2-2 显 示 的 那样 。 





SO@@e@ x localhost © © BB | 


[| 
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= 


| 























图 2-2 “我 的 冰箱 ”应 用 的 最 后 状态 


2.2 ”初始 设置 


在 继续 学 习 之 前 ， 确 保 你 已 经 在 机 器 上 安装 了 Meteor。 完 整 的 安装 过 程 请 参考 附录 A。 记 得 
Meteor 还 带 有 一 个 命令 行 工具 吗 ? 你 将 使 用 它 在 一 个 shell 环 境 中 进行 应 用 程序 的 初始 设置 。 它 允 
许 你 创建 新 的 应 用 。 在 下 面 的 小 节 中 ， 你 将 在 终端 中 执行 所 有 的 步骤 。 
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建立 新 项 目 








Meteor 安 装 好 后 ， 它 的 CLI 工 具 即 可 使 用 。 创 建 Meteor 项 目 只 需 在 终端 上 使 用 一 个 命令 : 





$ meteor create myFridge 

这 个 命令 创建 了 包含 三 个 文件 的 项 目 文件 夹 : 一 个 HTML 模板 文件 、 一 个 JavaScript 代 码 文件 
和 一 个 CSS 样 式 信息 文件 。 

进入 项 目 文件 夹 ， 使 用 CLI 工 具 启 动 应 用 程序 ， 如 下 所 示 : 


$ cd myFridge 
$ meteor run 


将 终端 控制 台 移 到 后 台 , 现在 开始 在 你 选择 的 编辑 咒 中 进行 编码 。 编 码 时 检查 终端 中 是 否 显 
示 任 何 错误 消息 , 这 是 有 用 的 , 但 在 本 章 的 其 余部 分 , 你 不 需要 重新 启动 服务 器 。 每 次 修改 一 个 
文件 ,甚至 添加 新 的 文件 ，Meteor 都 将 会 自动 进行 处 理 。 如 果 密 切 关注 一 下 ， 你 会 注意 到 ， 每 个 
文件 更 改 后 ， 控 制 台 都 会 显示 服务 器 已 重新 启动 ， 或 客户 端 代码 已 被 修改 ， 并 已 刷新 。 图 2-3 中 
显示 了 这 类 输出 。 





















































人 四国 myFridge 
MacBook:myFridge stephan$ meteor 
[[[[[ ~/Documents/Code/local/myFridge ]]]]] 


=> Started proxy. 
=> Started MongoDB, 
=> Started your app， 


=> App running at; http://localhost:3000/ 
=> Meteor server restarted 

=> Meteor server restarted 

=> Client modified -- refreshing 





图 2-3 ”Meteor 会 在 应 用 程序 代码 更 改 时 自动 重新 启动 服务 器 





2.3 创建 布局 

开发 这 个 游戏 的 第 一 步 是 思考 布局 。 对 这 个 应 用 来 说 ,我们 需要 一 个 简单 的 布局 , 左边 是 冰 
箱 ， 右 边 是 货架 上 的 物品 列表 。 物 品 可 以 从 一 边 拖 动 到 男 一 边 。 

要 创建 布局 ， 需 要 创建 一 些 模板 ， 添 加 图 片 ， 并 添加 一 个 方法 来 遍历 物品 列表 。 



































说 明 因为 这 本 书 是 关于 Meteor 而 不 是 关于 CSS 的 ， 所 以 我 们 不 会 详细 讨论 样式 。 你 可 以 参考 相 
关 的 代码 示例 来 浏览 所 有 样式 。 


2.3.1 设置 样式 
作为 基本 的 结构 ， 我 们 希望 有 一 个 冰箱 和 一 个 物品 列表 并 排 显 示 ， 如 图 2-4 所 示 。 
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<div id="fridge"> 


se 


<div class="container" /> 


























<div id="supermarket"> 
图 2-4 “我 的 冰箱 ”布局 中 三 个 主要 的 div 容 器 


第 一 步 是 根据 代码 清单 2-1 在 myFridge.css 内 设置 样式 的 总 体 布局 ， 这 样 你 就 可 以 专注 于 
HTMLIL 模 板 。 定 义 容 器 的 wigtn 设 置 并 确保 冰箱 显示 在 左边 ， 物 品 列表 ( 在 右边 ) 相对 小 一 点 。 


代码 清单 2-1 总 体 布局 风格 
.containert{ < 二 一 
width: 95%; 
position: relative; 











} 
这 些 只 是 定位 元 素 ， 
.left{ < | 在 代码 示例 中 可 看 
float: left; 到 完整 的 代码 


width: 60%; 
margin-right: 2%; 


} 





;TLOFE{ Sh 
float: right; 
width: 37%; 

} 


代码 清单 2-1 定 义 了 三 个 类 来 定位 div 容 器 。 因 为 希望 我 们 的 应 用 可 以 在 移动 电话 上 工作 ， 所 
以 使 用 百分比 来 使 布局 具有 适应 性 。 
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2.3.2 ”添加 模板 


对 每 个 div 元 素 使 用 一 个 独立 的 模板 , 即使 容器 也 是 这 样 。 完 成 以 后 , 将 有 一 个 head 、 一 个 body 
和 四 个 模板 。 
口 container 
口 fridge 


为 总 布局 

左边 显示 的 冰箱 

右边 显示 的 物品 列表 

口 productListItem 在 任何 一 方 显 示 的 项 目 

让 我 们 从 前 三 个 模板 开始 。 请 按 如 下 代码 清单 所 示 ， 更 新 myFridge.html 的 内 容 。 


代码 清单 2-2 骨架 模板 结构 











D productList 



































<head> 
<title>myFridge</title> 
</head> 
<body> 
{{> container}} < 
</body> 
<template name="container"> < 
<div class="container"> We 
<div class="left"> 从 子 模板 包含 
{{> fridge}} 内 容 
</div> 
<div class="right"> 
{{> productList}} 
</div> 
</div> 
</template> 
子 模 板 通过 
a 
<template name="fridge"> < | 名 字 引 用 
<div id="fridge"> 
</div> 
</template> 
<template name="productList"> < 





<div id="supermarket" class="box"> 
/divs 
</template> 
container 模 板 是 应 用 程序 的 基本 布局 , 它 把 冰箱 放 在 左边 , 物品 列表 放 在 右边 ,在 技术 上 ， 
我 们 可 以 对 所 有 的 HTML 代 码 使 用 一 个 模板 , 但 模板 拆 分 可 提供 更 好 的 结构 ， 更 好 地 控制 在 哪里 
显示 什么 。 
现在 , 你 已 经 创建 了 骨架 布局 , 我 们 让 左边 看 起 来 像 一 个 实际 的 冰箱 。 冰 箱 应 该 由 一 个 打开 
的 冰箱 图 像 来 表示 。 这 样 ， 我们 需要 扩展 该 项 目 , 使 之 能 够 添加 图 像 文 件 。 因 为 在 示例 应 用 程序 
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中 没有 使 用 图 像 ， 所 以 我 们 在 应 用 程序 的 根 目录 下 创建 一 个 名 为 public 的 新 文件 来。 这 里 将 存放 
所 有 的 图 像 。 


说 明 public 文 件 夹 按照 惯例 被 特殊 对 待 。 放 到 该 文件 夹 中 的 每 个 文件 都 可 以 在 URL 概 路径 上 访 
问 。 如 果 把 一 个 名 叫 image.jpg 的 文件 放 到 public 文 件 夹 ， 可 以 通过 HTTP://localhost: 
3000/image.jpg 来 访问 。 





要 在 浏览 器 中 包含 一 个 空 冰 箱 的 图 像 ， 你 可 以 使 用 本 章 源 代码 中 的 myFridge/public/ 
empty-fridgejpg 文 件 。 在 模板 中 引用 它 时 不 需要 包含 /public 路 径 ， 可 像 下 面 这 样 使 用 : 

<img class="image-responsive" src="/empty-fridge.jpg" /> 

我 们 的 冰箱 应 该 在 右边 包含 没有 排序 的 物品 列表 ,也 用 图 像 表 示 。 在 某 个 给 定 的 时 刻 , 我 们 
不 知道 有 多 少 物 品 在 冰箱 里 , 故 需要 一 个 灵活 的 解决 方案 来 遍历 物品 列表 。 因 此 , 我 们 将 使 用 一 
个 专用 的 物品 列表 模板 。 

在 模板 里 面 遍 历 对 象 数组 可 以 使 用 {{#each}} 辅 助 函 数 。 前 面 的 # 表 明 它 不 会 替代 占 位 符 ， 
只 是 提供 某 种 形式 的 逻辑 功能 。 你 将 创建 一 个 无 序列 表 并 遍历 proqucts 数 组 。 代 码 清 单 2-3 显 示 
了 它 的 应 用 方法 。 


代码 清单 2-3 ”在 productsList 模 板 中 使 用 each 辅 助 函数 遍历 物品 


<template name="productList"> 
<div id="supermarket" class="box"> 
Ul "Ld"OrIOde te 
{{#each products}} 
<li>{{> productListItem}}</1i> 
{{/each}} 
</ul> 





























</div> 
</template> 


对 于 数组 中 每 个 传递 给 这 个 辅助 函数 的 对 象 ，each 标 签 中 的 内 容 都 会 被 绘制 一 次 。 在 这 种 
情况 下 , 你 希望 传递 给 辅助 函数 的 每 个 物品 都 会 被 绘制 成 一 个 列表 元 素 。 而 该 列表 元 素 内 容 为 一 
个 想 在 这 里 插入 的 模板 {{> productListItem}}。 在 循环 中 使 用 模板 的 优点 是 ， 在 应 用 右 侧 的 
物品 列表 中 可 再 次 使 用 相同 的 模板 productListItem， 这 意味 着 你 可 以 写 更 少 的 代码 。 

在 HTML 文 件 的 底部 添加 新 的 模板 ， 如 下 所 示 。 


代码 清单 2-4 ”productListItem 模 板 
<template name="productListItem"> 
<img src="{{img}}" 
data-id="{{_iqd}}" 
class="image-responsive product-image draggable" /> 
</template> 


接 下 来 在 myFridge.html 文 件 中 调整 冰箱 模板 ,使 它 的 代码 看 起 来 如 代码 清单 2-5 所 示 。 
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代码 清单 2-5 在 tridqge 模 板 中 遍历 每 个 物品 


<template name="fridge"> 
<div id="fridge"> 
<img class="image-responsive" src="/empty-fridge.jpg" /> 
<ul> 
{{#each products}} 
<li>{{> productListItem}}</1i> 
{{/each}} 
CAL 
</div> 
</template> 


正如 你 所 看 到 的 ， 在 冰箱 和 超市 的 模板 中 重用 了 {{> productListItem}} 模 板 。 下 一 步 ， 








我 们 希望 能 够 绘制 一 些 物品 ， 也 就 是 物品 列表 ， 现 在 冰箱 还 是 空 的 。 
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现在 布局 已 经 到 位 ,我们 可 以 把 重点 放 在 后 端 。 所 有 的 物品 ,无 论 是 否 在 冰箱 里 ， 都 应 该 从 








数据 库 中 获得 。 一 旦 在 数据 库 中 存在 ,它们 就 应 该 被 发 送 到 客户 端 ， 所 以 我 们 需要 添加 数据 库 和 
模板 之 间 的 连接 。 


2.4.1 ”在 数据 库 中 存储 物品 








Meteor 捆 绑 了 MongoDB 数 据 库 作 为 默认 的 数据 库 。 由 于 紧密 的 整合 ， 使 用 MongoDB 时 不 需 














要 指定 连接 字符 串 或 登录 凭证 。 要 与 数据 库 进 行 通 信 , 我们 需要 声明 一 个 新 的 集合 (collection )。 
MongoDB 使 用 集合 而 不 是 数据 库 表 ， 因 为 它 是 NoSQL 数 据 库 或 者 说 是 个 面向 文档 的 数据 库 。 集 
合 包含 一 个 或 多 个 文档 形式 的 数据 。 第 4 章 涵 盖 了 数据 库 工 作 的 相关 细节 ， 现 在 我 们 专注 于 把 冰 


ran 


相 





应 用 的 功能 变 得 更 加 齐全 。 











I7 











使 用 Mongo .collection 定 义 新 的 数据 库 集 合 ， 并 用 来 搬入、 删除、 更 新 和 查找 文档 。 因 为 








集合 用 来 存储 物品 ， 所 以 需要 为 它们 命名 并 放 在 JavaScript 文 件 中 ， 如 下 所 示 。 


代码 清单 2-6 ”在 客户 端 和 服务 顺 端 声明 物品 集合 


2 


Products = new Mongo.Collection('products'); 
if (Meteor.isClient) { 
J fre 
} 
if (Meteor.isServer) { 
Lp 
} 


你 应 该 把 这 些 代码 放 在 文件 的 顶部 ， 在 任何 Meteor .isServet 或 Meteor .isclient 块 以 
因为 它 应 该 在 客户 端 和 服务 器 端 都 可 使 用 。 

所 有 的 物品 都 有 三 个 属性 : 

口 名 称 ， 例 如 面包 ; 
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口 一 个 /public 文 件 夹 下 相关 的 图 像 文 件 ， 如 bread.png; 
口 目前 的 位 置 ， 即 冰箱 或 超市 。 





使 用 浏览 器 内 部 的 JavaScript 控 制 台 
因为 Meteor 应 用 至 少 部 分 运行 于 浏览 器 上 ,所 以 你 有 时 需要 切换 到 JavaScript 控 制 台 来 查看 
调试 输出 信息 或 发 出 指令 。 所 有 主要 的 浏览 器 都 有 一 些 开 发 工具 , 使 你 可 使 用 简单 的 快捷 键 来 
访问 控制 台 
Chrome: 
口 在 Mac 上 ， 按 Option+Command+J; 
口 在 Windows 中 ， 按 Ctrl+Shift+J。 
Firefox : 
口 在 Mac 上 ， 按 Option+Command+K; 
口 在 Windows 中 ， 按 Ctrl+Shift+K。 
IE : 
口 在 Windows 中 ， 按 F12， 单 击 Scripts (脚本 ) 选项 卡 。 
Opera: 
口 在 Mac 上 ， 按 Option+Command+I; 
口 在 Windows 中 ， 按 Ctrl+Shift+I。 
Safari: 
口 在 Mac 上 ， 按 Option+Command+C。 














Ly 


在 浏览 器 中 打开 JavaScript 命 令 行 工 具 ， 使 用 下 面 的 命令 添加 一 些 数据 到 物品 集合 : 


Products.insert ({img: '/bread.png', name: 'Bread', place: 'fridge'}); 


这 个 函数 调用 的 返回 值 是 新 插入 物品 的 文档 ID。 有 了 这 个 ID , 你 就 可 以 从 数据 库 中 像 下 面 这 
样 得 到 该 文档 : 


Products.findOone({_id: 'X6Qw8v3ChcsZKaKan'}); 


因为 你 知道 只 有 一 个 对 象 具有 这 个 ID， 所 以 使 用 findone () 函数 。 返 回 值 是 数据 库 中 的 该 
物品 对 象 ( 参见 图 2-5 )。 














Q Elements Network Sources Timeline Profiles Resources Audits |Gonsole| 
© 字 <top frame> v 





> Product,insert({img: "/bread.png", name: "Bread", place: "fridge"}); 
"KHyHys32fcboj dNXz" 
> Product.findOne({_id: "KHyHys32fcbojdNXZ"}); 
Object {_id: "KHyHys32fcbojdNXZ", img: "/bread.png", name: "Bread", place: "fridge"} 
> 























图 2-5 ”使 用 浏览 器 的 JavaScript 控 制 台 插入 和 查找 数据 库 中 的 数据 
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开发 人 员 的 生产 效率 和 安全 性 

虽然 使 用 开发 控制 台 很 方便 从 数据 库 中 添加 和 删除 项 目 , 但 这 也 是 一 个 安全 风险 。 如 果 你 
能 这 样 做 ， 那 么 任何 使 用 该 应 用 的 人 也 能 够 这 样 做 。 

新 建 的 Meteor 项 目 总 是 包含 一 个 名 为 insecure 的 包 ， 它 禁用 身份 验证 检查 ， 允 许 任 何人 
读 取 和 写 入 任何 集合 。insecure 的 兄弟 包 autopublish 自 动 使 所 有 的 服务 器 端 集合 内 容 可 以 
在 客户 端 访 问 , 它们 使 开发 人 员 的 开发 更 容易 ,因为 这 让 开发 人 员 在 开发 的 早期 阶段 首先 专注 
于 功能 构建 ， 而 不 必 考 虑 认证 问题 。 

在 开发 过 程 中 ,你 很 有 可 能 引入 权限 管理 ， 只 允许 已 验证 用 户 发 布 数据 。 在 那个 时 候 ， 你 
可 以 使 用 以 下 的 命令 行 去 除 这 两 个 包 : 

$ meteor remove insecure 

$ meteor remove autopublish 



































通过 位 置 查 询 数 据 也 很 简单 。 可 以 通过 其 他 单个 属性 而 不 是 _ia 字 段 来 查询 物品 。 这 样 你 
得 到 的 不 是 一 个 单一 的 结果 , 故 要 使 用 fina () 寻找 所 有 pblace 属 性 都 为 tridge 的 数据 库 条 目 : 


Products.find({place: 'fridge'}); 
现在 ， 你 已 经 向 数据 库 中 添加 了 一 些 数 据 ， 并 且 可 以 在 浏览 锅 中 访问 和 查看 数据 。 
2.4.2 ”将 数据 连接 到 模板 


在 fridge 模 板 中 ， 需 要 遍历 所 有 place 属 性 是 fridge 的 物品 。 为 此 ， 你 将 使 用 辅助 函数 
products 来 扩展 该 模板 , 该 辅助 函数 返回 你 想 在 冰箱 里 显示 的 所 有 物品 。 让 我 们 再 看 一 次 模板 : 


<template name="fridge"> 

































































</template> 


Meteor 中 有 一 个 全 局 的 Template 对 象 ， 可 以 利用 它 通过 模板 的 名 字 来 访问 每 个 模板 。 每 个 
模板 对 象 有 个 函数 helpers, 该 函数 接受 一 个 关联 数组 作为 参数 , 数组 的 值 可 以 在 模板 中 通过 它 
的 键 值 来 访问 : 

Template.fridge.helpers ({ 
products: function(){ + 模板 中 的 每 个 标签 




















return []; 者 期望 一 个 数组 
} 


> 
对 fridge 模 板 而 言 ， 你 要 遍历 从 数据 库 中 取出 的 物品 数组 。 辅 助 函数 的 工作 是 从 数据 库 中 
查找 数据 并 将 其 传递 给 模板 。 请 记 住 ,为 了 显示 数据 ， 你 在 模板 中 使 用 {{#each 
products}}...{{/each})} 创 建 了 一 个 循环 : 
<template name="fridge"> 
<div id="fridge"> 


<img class="image-responsive" src="/empty-fridge.jpg" /> 
<ul> 
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ee 对 products 辅 助 函 
加 
{{/each}} re 
</ul> 到 
</div> 
</template> 


要 使 用 products 辅 助 函数 扩展 模板 fridge, 需要 把 它 传 给 remplate 对 象 的 helpers 函 数 。 
为 此 ， 你 需要 把 myFridge.js 文 件 中 的 Meteor .isclient 代 码 块 震 换 成 下 面 的 代码 。 


代码 清单 2-7 为 friage 模 板 设 置 products 辅 助 函 数 
Template.fridge.helpers({ 
products: function () { 
return Products.findl(t{ 
place: 'fridge' 
3 
} 
3) 避 


products 辅 助 函数 返回 所 有 place 属 性 是 fridge 的 物品 ， 就 像 你 想 要 的 那样 。 因 为 已 经 向 
冰箱 添加 了 一 个 物品 ， 所 以 它 应 该 会 被 直接 添加 到 视图 。 要 确保 已 经 将 关联 的 图 像 放 在 public 文 
件 夹 中 。 如 果 将 面包 添加 到 和 集合 文档 ， 并 在 public 文 件 夹 中 添加 了 相应 的 图 人像， 那么 应 用 将 看 起 
来 如 图 2-6 所 示 。 











© © /nidoe x (EE | 
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图 2-6 ”冰箱 显示 了 一 块 面包 的 图 像 
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对 于 在 右边 的 productList 模 板 ， 现 在 可 以 做 同样 的 事情 ， 只 是 在 查询 中 要 指定 一 个 不 同 
的 place 属 性 值 。 不 需要 显示 数据 库 中 的 所 有 物品 ， 而 只 是 显示 那些 目前 在 超市 的 物品 。 要 这 样 
做 ， 就 需要 查询 数据 库 ， 如 下 所 示 。 





mw 











代码 清单 2-8 为 pzodquctList 模 板 建立 prodqucts 辅 助 函 数 
Template.productList.helpers(t{ 
products: function () { 
return Products.findl(t{ 
place: 'supermarket' 
} 
上 








如 果 使 用 JavaScript 控 制 台 向 冰箱 或 者 超市 插入 更 多 的 物品 ， 你 会 看 到 它们 如 何 被 自动 添加 到 
屏幕 。 此 外 , 物品 的 插入 是 实时 完成 的 ,打开 男 一 个 浏览 带 , 你 会 看 到 物品 立即 被 添加 ( 参见 图 2-7 )。 
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© ® <topframe> v OPreserve log 
> Products.insert({ 


name: ‘Juice', 
img; '/juice.png', 
place: "supermarket' 





DD); 
< "KwXgDdDgZvLewarzT™" 
> | 











图 2-7 其 他 浏览 器 显示 ， 数 据 库 的 更 改 是 实时 的 


到 目前 为 止 , 你 已 经 创建 了 用 户 界面 ,并 设置 了 冰箱 应 用 所 需 的 数据 结构 。 要 做 的 最 后 一 件 
事 是 处 理 用 户 交 互 ， 让 用 户 把 物品 放 进 冰 箱 或 者 把 它们 从 冰箱 中 取出 。 





2.4.3 添加 一 组 预定 义 的 物品 


虽然 能 够 手动 添加 物品 有 时 是 有 用 的 ， 但 你 可 以 使 用 服务 器 在 启动 时 添加 一 组 预定 义 的 物 
品 。 这 样 ， 你 会 工作 在 一 个 已 知 的 状态 上 ， 无 论 在 前 面 的 运行 中 已 经 完成 了 多 少 测试 。 

代码 清单 2-9 中 的 JavaScript 代 码 将 在 服务 器 启动 时 从 数据 库 中 删除 所 有 物品 。 之 后 ， 它 会 把 
牛奶 放 在 冰箱 里 ， 把 面包 放 在 超市 里 。 

















代码 清单 2-9 在 服务 器 启动 时 将 一 个 预定 义 的 数据 集 添加 到 数据 库 中 


if (Meteor.isServer) { 服务 器 重新 
Meteor.startup(function () { 启动 时 执行 
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Products.remove ({}); | 从 数据 库 删除 
// 向 数据 库 中 添加 一 些 物品 人 





Products.insert ({ < 
name: 'Milk', 
J "/ri lk ping 插入 一 些 物品 
Dlaces “EFLidge 到 数据 库 

下 

Products.insert({ < 





name: 'Bread', 
img: '/bread.png', 
place: 'supermarket' 
过 
}); 

} 

按 Ctrl+C 停 止 Meteor 服 务 器 ， 然 后 重新 启动 它 。 如 果 把 牛奶 和 面包 的 图 像 从 示例 代码 复制 到 
你 的 public 文 件 夹 ， 你 现在 就 可 以 看 到 冰箱 里 有 一 个 瓶子 ， 右 边 有 个 面包 。 最 后 ， 我 们 将 通过 拖 
放 来 添加 交互 。 


2.5 把 物品 放 进 冰箱 里 


我 们 的 目标 是 使 物品 能 够 从 物品 列表 拖 动 到 冰箱 , 反之 亦 然 。 这 不 是 一 个 只 针对 Meteor 的 任 
务 , 而 是 一 个 标准 的 前 端 任 务 。 我 们 将 使 用 jQuery UI 库 进 行 拖 放 ， 并 和 模板 进行 必要 的 连接 。 作 
为 拖 放 的 结果 ， 我 们 也 需要 更 新 数据 库 ， 因 此 我 们 需要 添加 一 个 前 端 操 作 以 及 相关 的 后 端 操 作 ， 
该 后 端 操 作 要 能 够 在 数据 库 中 存储 内 容 。 

我 们 从 在 现 有 项 目 中 添加 jQuery UI 库 开 始 。 它 能 提供 可 工作 在 所 有 主流 浏览 器 上 的 拖 放 功 
能 。 一 旦 库 可 用 , 我 们 将 定义 冰箱 和 物品 列表 为 可 能 的 拖 放 目标 , 拖 放 目标 是 可 以 放置 物品 的 地 
方 。 最后， 每 个 物品 列表 项 将 被 标记 为 可 拖 放 ， 这 样 它 就 可 以 移动 到 某 个 拖 放 目 标 上 。 






























































2.5.1 为 项 目 添 加 jQuery UI 


不 一 定 要 在 项 目 文件 中 添加 jQuery UI 库 ， 因 为 你 可 以 包括 它 的 在 线 版 本 。 在 Meteor 中 的 工作 
方式 同 在 任何 其 他 HTML 文件 中 一 样 : 通过 将 其 添加 到 你 myFridge.html 文 件 的 <heaq> 区 域 〈 参 
见 下 面 的 代码 清单 )。 


代码 清单 2-10 从 CDN 加 载 jQuery UI 
<head> 
<title>myFridge</title> 
<script src="//code.jquery.com/ui/1.11.4/jaquery-ui.js"></script> 
</head> 


现在 , 库 从 jquery.com 加 载 。 显然 你 需要 一 个 Internet 连 接 ， 因 为 要 使 用 内 容 分 发 网 络 ( CDN ) 
提供 JavaScript 文 件 。 或 者 你 可 以 从 http://jqueryui.com 下 载 库 ， 并 把 文件 jquery-ui.min.js 放 到 client 
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文件 来。Meteor 将 自动 提供 这 个 文件 并 在 客户 端 加 载 该 文件 。 如 果 你 在 本 地 添加 文件 ， 要 确保 在 
模板 文件 中 的 nead 部 分 不 包括 script 标 签 。 
2.5.2 ”为 物品 定义 拖 放 目标 


为 支持 拖 放 ， 你 要 使 用 jQuery 的 API 定 义 ftridqge 和 proquctList 为 可 能 的 拖 放 目标 。 因 为 在 
fridge 和 productList 被 绘制 成 DOM 之 前 , 不 能 使 用 jQuery UI 来 对 它们 进行 任何 修改 , 所 以 你 
必须 等 到 每 个 模板 都 被 绘制 完成 。 每 个 模板 都 有 一 个 回调 也 数 ， 这 使 得 这 件 事 情 很 容易 做 到 ”. 


Template.fridge.onRendered(function() { 











Var templateInstance = this; 这 个 模板 实例 中 ， 我 们 
限制 了 jQuery 的 范围 ， 
templateInstance.$('#fridge') .droppablel({ 而 不 是 解析 整个 DOM 


drop: function(evt; wi) 
// do something 


使 用 jQuery 解析 部 分 DOM 

每 次 看 到 $ () 代码, 你 都 可 以 肯定 这 里 用 到 了 jQuery。 通常 这 也 意味 着 整个 DOM 树 被 解析 ， 
这 是 相当 缓慢 的 , 而 且 往 往 不 是 你 想 要 的 。 当 你 尝试 为 body 设 置 背 景 闫 色 时 ,使 用 $ ('body ') 
是 完全 可 以 接受 的 。 但 大 多 数 时 候 ， 你 希望 一 个 模板 不 要 修改 其 他 模板 。 而 完整 的 DOM 解 析 
会 影响 性 能 ， 而 且 调 试 也 将 变 成 一 场 性 梦 。 

Meteor 提 供 了 一 个 简单 的 解决 方案 ， 以 限制 jQuery 的 活动 在 当前 模板 范围 内 : Template. 
instance() 包含 一 个 代表 当前 模板 的 对 象 。 在 回调 函数 created、rendered 和 destroyed 
中 ， 可 以 通过 this 使 用 该 对 象 。 例 如 ， 你 可 以 限制 jQuery 的 范围 为 该 对 象 ， 然 后 安全 地 在 多 个 
模板 中 使 用 .dateinput 类 ， 而 这 不 会 导致 formTemplate 突 然 创 建 了 满天飞 的 日 期 选择 器 。 

因为 直接 使 用 his 可 能 会 让 人 困惑 ， 所 以 你 应 该 使 用 一 个 更 有 意义 的 标识 符 ， 如 前 面 的 
代码 示例 中 使 用 的 templateInstance。 














当 fridge 模 板 被 绘制 时 ， 你 定义 <aiv ia="fridge"> 作 为 一 个 可 拖 放 的 目标 。 这 意味 着 可 
以 简单 地 通过 将 DOM 元 素 拖 到 giv 区 域 ,动态 地 把 它们 添加 到 该 aiv。 基 本 上 ， 这 是 在 监听 一 个 
事件 〈《 即 ， 用 户 拖 动 一 个 项 目 到 容器 上 )， 所 以 你 必须 定义 一 个 事件 处 理 程序 来 确定 是 否 有 东西 
被 拖 到 容器 中 。 事 件 处 理 程序 还 需要 对 数据 库 中 的 相关 项 目 进 行 更 新 ， 也 就 是 更 新 它 的 位 置 。 

事件 处 理 程序 名 为 arop ,一 旦 某 个 物品 被 移动 ,事件 处 理 程序 就 会 改变 该 物品 的 place 属 性 。 
要 确定 被 拖 动物 品 在 数据 库 中 的 相关 条 目 ， 需 要 将 数据 的 ID 传 给 它 。 在 JavaScript 事 件 处 理 程 序 
中 ,函数 带 有 两 个 参数 : event 和 ui 对 象 。drop 回 调 函 数 的 ui 对 象 可 用 来 确定 被 拖 动 物品 的 人 D。 



















































































@ 第 3 章 将 会 详细 介绍 如 何在 当前 模板 的 范围 内 使 用 jQuery。 
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是 某 个 proquctListItem 项 。 很 容易 确定 哪些 HTML 元素 被 拖 动 了 ， 但 还 需要 连接 到 数据 库 ， 
这 就 是 需要 qata-id 属 性 的 地 方 : 
<template name="productListItem"> 

<img src="{{img}}" data-id="{{_id}}" class="image-responsive product-image 


draggable" /> 
</template> 


这 里 给 <img> 添 加 了 一 个 名 为 aata-iaq 的 属性 。daata-iad 属 性 的 值 被 设置 为 ia， 表示 数据 
库 中 该 物品 的 ID。 这样 当 你 拖 动 图 像 时 , 就 有 一 个 简单 的 方法 来 确定 数据 库 中 受 影响 的 物品 ,你 
可 以 据 此 改变 它 的 place 属 性 。 可 使 用 与 插入 新 物品 类 似 的 语法 ， 通 过 调用 update () 函数 来 更 
新 proqucts 集 合 中 的 某 条 数据 。 你 所 需要 做 的 是 提供 该 物品 在 数据 库 中 的 ID ， 并 把 place 属 性 
设置 为 它 被 拖 到 的 位 置 ， 如 代码 清单 2-11 所 示 。 


代码 清单 2-11 声明 冰箱 为 拖 放 目 标 并 更 新 物品 的 位 置 






































Template.fridge.onRendered(function () { 从 HTML 的 data-id 
Var templateInstance = this; 二 但 
属性 获得 数据 库 中 
的 ID 


templateInstance.s$ ('#fridge') .droppablel({ 
drop: function(evt, ui) { 
var query = { _id: ui.draggable.data('id') }; | 
Var changes = { S$set: { place: 'frigdge' } }; < 一 
Prodqucts.updaate (duery，chandges) ; 圭一 执行 数据 库 
订 更 新 
下 


记 住 ，data-id 以 及 该 拖 动 图像 相 关 物 品 的 _iqdq， 可 通过 ui .draggable 对 象 获 得 。 


设置 更 新 语句 ， 把 
place 设 为 fridge 


使 用 jQuery 来 访问 元 素 的 属性 

为 了 尽量 减少 代码 量 ， 可 使 用 一 个 速记 符号 来 获得 任何 物品 的 ID。 你 可 以 使 用 jQuery 来 访 
问 HTML5 数 据 集 API 的 元 素 。 

不 同 于 jQuery UI， 基 本 的 jQuery 功能 是 和 Meteor 捆 绑 在 一 起 的 ， 所 以 不 需要 在 任何 项 目 中 
明确 地 包含 它 。HTML5 的 数据 集 API 指 定 DOM 中 的 每 个 元 素 可 以 拥有 额外 的 属性 ， 属 性 的 名 
字 以 data- 开 始 。 将 元 数据 附加 到 页 面 上 的 元 素 上 是 非常 有 用 的 。 从 jQuery 版 本 (1.4.3 开 始 ) 
开始 ， 你 不 必 通 过 attr('data-id') 来 访问 属性 ， 只 需要 使 用 data('id') 就 可 以 了 。 

因此 ,访问 一 个 物品 的 data-id 属 性 可 以 这 样 做 : 

$s (ui.draggable) .data('id') 

甚至 可 以 删除 $ () 来 进一步 缩短 代码 ， 这 样 就 只 留 下 了 ui 对 象 : 

ui.draggable.data('id') 


你 可 以 在 上 述 的 两 个 方法 中 选择 一 个 。 


2.5 把 物品 放 进 冰箱 里 ”39 








你 创建 了 一 个 查询 , 在 Products 集 合 中 找到 正确 的 物品 文档 ,传递 给 Products .update () 
的 第 一 个 参数 就 像 前 面 那样 工作 : 它 返 回 一 个 基于 该 DD 的 文档 。 第 二 个 参数 使 用 $set 函数 指定 
要 更 新 该 文档 的 字段 。 要 更 新 的 数据 是 place 属 性 ， 因 为 这 是 一 个 拖 放 事件 ， 如 果 一 个 项 目 被 拖 
放 在 冰箱 上 就 会 被 调用 ， 所 以 你 要 将 它 的 place 属 性 改 为 fridge。 

物品 列表 也 是 一 个 拖 放 目 标 , 因此 也 需要 几乎 相同 的 代码 , 但 有 两 个 小 而 重要 的 差异 。 再 次 ， 
productList 模 板 的 rendered 子 数 需 要 用 来 等 待 DOM 事 件 。 如 果 一 个 项 目 被 拖 放 到 
progductList 模 板 上 ， 该 物品 的 文档 bplace 属 性 必须 更 改 。 这 一 次 需要 设置 它 的 值 为 super- 
market 而 不 是 fri dgeo 下 面 的 代码 清单 显示 了 所 需 的 代码 o 


代码 清单 2-12 ”声明 productList 作 为 拖 放 目 标 
Template.productList.onRendered(function() { < 一 
Var templateInstance = this; 









































productList 是 Meteor 


使 用 的 模板 名 字 





templateInstance.$('#supermarket') .Qroppable({ 站 总 下 
supermarket 是 div 
drop: function(evt, ui) { 的 ID 
var query = { _id: ui.draggable.data('id') }; : 
Var changes = { S$set: { place: 'supermarket' } }; | 当 物 品 被 拖 动 时 
pn YJ， 





Products.update(query, changes); 把 place 属 性 设置 
又 


洒 为 supermarket 


} 


2.5.3 ”允许 物品 被 拖 动 


现在 已 经 设置 好 拖 动 目标 , 但 是 你 还 必须 定义 可 能 被 拖 动 的 元 素 : 可 拖 动 项 , 在 这 个 应 用 中 ， 
每 个 productListItem 元 素 应 该 可 以 拖 动 。 再 次 使 用 jQuery UI 来 标记 列表 项 为 可 拖 动 ， 这 里 使 
用 了 productListItem 的 rendered 也 数 。 在 每 个 bproductListItem 的 绘制 过 程 中 , rendered 
回调 函数 都 将 被 执行 一 次 ， 这 将 有 效 地 使 每 个 食品 可 移动 ( 见 下 面 的 代码 清单 )。 


代码 清单 2-13 ”声明 progductListItem 为 可 拖 动 项 
Template.productListItem.onRendered(function() { 
var templateInstance = this; 























templateInstance.$('.draggable') .draggablel(l{ 
cursor: 'move', 
helper: 'clone' 

让 

区 





注意 , 代码 清单 2-13 使 用 templateInstance.$('.draggable') 来 访问 HTML 中 被 拖 动 的 
元 素 。 在 我 们 的 例子 中 它 是 <img>。 在 这 个 模板 的 上 下 文中 使 用 jQuery ， 使 Meteor 只 在 
productListItem 模 板 中 而 不 是 整个 DOM 树 中 搜索 一 个 元 素 ， 这 使 它 更 高 效 。 
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2.6 ”部署 应 用 到 meteor.com 并 使 用 它 


你 现在 有 一 个 应 用 ,可 以 将 一 个 图 像 从 右边 的 物品 列表 拖 动 到 左边 的 冰箱 , 反之 亦 然 。 当 
像 被 拖 放 时 ,底层 的 物品 文档 将 相应 地 更 新 。 该 变化 会 反映 在 用 户 界面 上 ,物品 会 自动 在 正确 的 
地 方 绘制 。 

如 果 要 与 世界 分 享 你 的 冰箱 ， 可 以 使 用 aeploy 命 令 在 Meteor 测 试 服务 器 上 部 署 它 。 随 便 挑 
一 个 没有 被 使 用 的 名 字 作 为 可 以 访问 该 应 用 的 子 域名 。 如 果 该 子 域名 已 经 被 使 用 , 你 会 看 到 一 个 
错误 消息 。 

下 面部 署 我 们 的 项 目 到 mia-ch02-myfridge， 使 用 以 下 命令 : 


$ meteor deploy mia-ch02-myfridge 


为 了 确保 只 有 你 可 以 访问 、 更 新 或 删除 测试 服务 器 上 的 该 应 用 ， 它 会 与 你 的 Meteor 个 人 开发 
账户 相关 联 ， 而 个 人 开发 账户 是 基于 你 的 电子 邮件 地 址 。 因 此 ， 你 必须 在 第 一 次 部 署 时 提供 电子 
邮件 地 址 。Meteor 会 在 你 的 工作 机 器 上 记 住 这 个 地 址 。 此 外 ， 你 将 得 到 一 封 电子 邮件 回复 ,解释 
如 何 用 密码 保护 你 的 账户 。 部 署 完 成 后 ， 可 以 使 用 你 选 定 的 meteorcom 子 域名 来 访问 你 的 应 用 ， 
在 我 们 的 例子 中 ， 这 个 地 址 是 http://ch02-mia-myfridge.meteor.com。 

现在 你 可 以 和 一 个 朋友 分 享 这 个 网 址 (或 者 在 同一 台电 脑 上 打开 两 个 浏览 器 )， 并 开始 拖 放 
物品 。 你 会 看 到 所 有 的 变化 都 几乎 立即 在 所 有 的 客户 端 反映 出 来 。Meteor 会 让 所 有 连接 的 客户 端 
保持 同步 ,即使 你 从 来 没有 定义 任何 特定 的 代码 。 你 也 永远 不 必 写 任何 代码 来 轮 询 服务 器 的 任何 
数据 库 更 新 。 这 是 全 栈 式 响应 性 在 起 作用 。 

在 接 下 来 的 章节 中 ,我 们 将 看 看 这 里 所 有 的 部 件 是 如 何 神奇 地 组 合 在 一 起 工作 的 。 你 会 发 现 ， 
所 有 这 一 切 的 背后 只 是 写 好 的 熟悉 的 JavaScript， 并 没有 什么 魔法 。 












































































































































2.7 总 结 


在 本 章 中 ， 你 已 经 了 解 到 ， 

口 出 于 开发 的 目的 ，meteor CLI 工 具 在 后 台 运 行 整个 Meteor 栈 ; 
口 Spacebars 是 Meteor 使 用 的 模板 语言 ; 

口 集合 用 于 与 数据 库 交互 ; 

静态 文件 ， 如 图 像 ， 放 在 public 文 件 夹 ; 

口 数据 的 变化 会 向 所 有 的 客户 端 推送 。 











3 之 ， 1 一 一 撞击 ， 


现在 ， 在 熟悉 了 Meteor 平 台 的 基本 概念 以 后 ， 你 将 会 详细 了 解 响应 式 应 用 的 各 个 组 成 部 分 。 
从 用 户 界面 和 模板 (第 3 章 ) 开始 ， 我 们 将 逐渐 在 栈 中 展开 工作 。 我 们 将 解释 如 何 使 用 数据 和 
响应 式 编辑 〈 第 4 章 和 第 5 章 ) 、 添 加 用 户 (第 6 章 ) 、 管 理 数据 发 布 (第 7 章 ) 、 使 用 路 由 (第 8 
章 ) 、 在 包 中 组 织 代 码 (第 9 章 ) ， 以 及 在 服务 器 上 写 同 步 和 异步 代码 (第 10 章 ) 。 











本 章 内 容 

口 创建 模板 

口 用 Meteor 默 认 的 模板 语法 
口 组 织 JavaScript 和 HTML 

口 使 用 事件 映射 进行 模板 交互 
口 了 解 模 板 生命 周期 














Web 浏 览 器 泻 染 的 一 切 ， 最 终 都 是 HTML。 只 要 打开 任何 一 个 网 站 的 源码 视图 ， 你 就 会 发 现 
每 一 个 网 页 都 有 几 百 行 HTML 代 码 。 手 动 书写 HTML 代 码 不 仅 繁 珊 、 易 错 、 低 效 ， 而 且 也 是 不 可 
能 的 一 一 在 写 Web 应 用 时 ， 大 部 分 内 容 是 动态 的 ， 你 不 可 能 事先 确切 地 知道 需要 泻 染 什么 代码 。 

模板 允许 你 定义 可 以 无 限 重复 使 用 的 HTML 块 。 这 样 ， 你 只 需要 写 少 量 的 代码 ， 而 且 代 码 会 
更 容易 阅读 ， 维 护 起 来 也 更 简单 。 

在 本 章 中 ,你 将 学 习 如 何 写 模 板 , 以 及 可 以 用 它们 来 做 什么 。 我 们 先 看 看 Meteor 的 响应 式 UI 
库 Blaze 和 默认 的 模板 语言 Spacebars。 


3.1 模板 介绍 


模板 可 用 于 构建 UI。 它 是 包含 占 位 符 的 HTML 片 段 ， 其 占 位 符 可 以 用 应 用 逻辑 返回 的 内 容 填 
充 。 模 板 可 以 重复 使 用 ， 以 确保 所 有 网 站 和 所 有 元 素 有 相同 的 外 观 。 

模板 的 另 一 个 重要 特点 是 关注 点 分 离 (separation of concerns )。 这 意味 着 模板 仅 用 于 表示 数 
据 , 并 最 终 呈 现 为 DOM 中 的 HTML。 模板 应 尽 可 能 不 包含 编程 逻辑 。 一 切 需 要 计算 以 及 带 有 特定 
输出 的 部 分 都 不 应 该 出 现在 模板 中 , 它们 需要 分 离 成 一 个 JavaScript 文 件 。 这 种 方法 有 助 于 提高 可 
读 性 ， 这 和 将 HTML 的 样式 分 离 为 级 联 样式 表 ( CSS ) 是 相同 的 概念 ， 即 不 要 把 HTML 和 样式 定 
义 文 件 放 在 一 起 。 

想象 一 个 简单 的 用 户 列表 ， 如 图 3-1 所 示 。 对 于 每 个 用 户 ， 该 列表 将 显示 其 名 字 和 电话 号 码 。 
由 于 不 知道 此 列表 需要 显示 多 少 人 的 信息 ， 因 此 可 以 使 用 动态 模板 生成 必要 的 HTML 代 码 。 
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此 例 使 用 < 
符 告诉 模板 处 更 


€ SC D0 localhost:3000 


e。 Christina 





Phone: 1234-567 


e Stephan 


Phone: 666-999-321 


e。 Manuel 


Phone: 987-654-321 

















<h5>{{NAME}}</h5> 
<p>Phone: {{PHONE}}</p> 


因为 占 位 符 可 以 包含 多 个 元 素 ， 所 以 需要 该 模板 能 够 创建 任意 数量 的 列表 项 。 就 像 在 
JavaScript 代 码 中 那样 ,你 可 以 使 用 循环 , 将 数组 作为 输入 , 遍历 每 个 数组 的 内 容 , 使 用 每 个 人 的 
名 字 (name ) 和 电话 号 码 (phone ) 填充 占 位 符 。 在 这 个 例子 中 ， 你 将 创建 一 个 用 户 列 表 ， 重 用 


profile 模 板 。 对 于 每 个 人 ， 它 应 该 包含 以 下 内 容 : 


<ul> 


</ul> 


<!-- 对 每 个 用 户 ， 绘 制 下 面 的 内 容 : --> 

















图 3-1 一 个 显示 用 户 名 字 和 








电话 号 码 的 列表 





h5> 元 素来 显示 名 字 , 并 将 电话 号 码 置 于 <p> 元 素 中 。 使 用 包含 双重 大 括号 的 占 位 
器 你 想 要 把 内 容 放 在 哪里 。 如 果 使 用 伪 代 码 ， 此 例 需 要 的 模板 看 起 来 像 这 样 : 





<li>{{ LOOP_THROUGH_PERSON_LIST_USING TEMPLATE }} </1i> 














把 











代码 清单 3-1 ”由 模板 泻 染 的 HTML 


<ul> 


<1i> 
<h5>Christina</h5> 
<p>Phone: 1234-567</p> 
</1i> 
<1i> 
<h5>Stephan</h5> 
<p>Phone: 666-999-321</p> 
去 兴工 并 > 
< 工 工 > 
<h5>Manuel</h5> 
<p>Phone: 987-654-321</p> 
</1i> 


</ul> 


模板 与 后 端 逻辑 连接 起 来 将 返回 如 下 HTML 代 码 。 
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使 用 模板 的 优点 是 只 写 一 次 ， 然 后 就 可 以 将 它们 用 于 演 染 无 限 数量 的 数据 ( 在 上 例 中 是 用 
户 ) 有 一 个 地 方 来 管理 元 素 的 外 观 也 方便 。 考 虑 在 下 面 的 情况 下 你 需要 做 什么 : 你 不 想 使 用 <h5> 
元 素 ， 而 只 想 使 用 常见 的 <p> 元 素来 显示 用 户 的 名 字 。 你 只 需要 在 模板 中 改变 它 ， 所 有 使 用 
profile 模 板 泻 染 的 用 户 信 息 都 会 立刻 更 新 。 


3.2 ”使 用 模板 


除非 你 正在 编写 一 个 服务 器 应 用 ， 否 则 每 个 在 Meteor 中 开发 的 Web 应 用 都 应 该 至 少 有 一 个 模 
板 。 在 浏览 器 中 不 使 用 模板 来 显示 内 容 是 不 可 能 的 。 本 节 讨 论 了 使 用 模板 工作 的 基础 。 





























3.2.1 Blaze 引擎 


在 幕后 ，Meteor 使 用 一 个 称 为 Blaze 的 响应 式 用 户 界 面 库 。 它 负责 处 理 模板 ， 是 经 常 被 称 为 
“Meteor 魔 法 ”的 一 个 重要 组 成 部 分 。 正 如 你 在 图 3-2 中 看 到 的 ，Blaze 由 两 个 主要 部 分 组 成 。 
口 运行 时 API 
口 构建 时 编译 器 





















































图 3-2” ”Blaze 的 组 成 部 分 
运行 时 API 泻 染 元 素 ， 跟 踪 它 们 的 依赖 关系 ， 并 在 这 些 依赖 关系 改变 时 ， 通 过 它们 的 完整 生 


























命 周 期 更 新 相关 元 素 。 这 意味 着 如 果 一 个 人 的 电话 号 码 在 数据 库 中 改变 了 , 而 某 个 用 户 正 在 浏览 
的 一 个 页 面 上 有 这 个 人 的 信息 , 这 个 电话 号 码 就 会 在 屏幕 上 自动 更 新 。 这 是 因为 占 位 符 的 内 容 取 
决 于 存储 在 数据 库 中 的 实际 值 ， 而 这 个 值 是 一 个 响应 式 数据 源 。 

运行 时 API 和 JavaScript 相 结合 ， 以 应 用 响应 性 。 它 不 能 直接 处 理 HTML， 这 就 是 为 什么 Blaze 
的 第 二 部 分 是 一 个 构建 时 编译 器 。Meteor 附 带 一 个 编译 回 ,可 以 将 HTML 转 换 成 JavaScript ( 准确 
地 说 就 是 HTMLJS )。 默 认 情 况 下 ， 它 使 用 Spacebars 来 处 理 模 板 。 或 者 ， 也 可 以 使 用 包 来 切换 到 
不 同 的 模板 编译 语言 ， 比 如 Jade。 

这 两 个 组 件 分 别 工作 ,因此 完全 有 可 能 绕 过 构建 时 编译 器 , 不 使 用 任何 模板 ， 而 是 直接 写 面 
向 运行 时 API 的 代码 。 因 为 这 种 方式 对 大 多 数 用 户 而 言 不 是 非常 实用 ， 所 以 我 们 不 用 担心 运行 时 
API 本 身 ， 而 应 集中 注意 力 使 用 Spacebars。 
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说 明 Meteor 的 模板 语言 叫 作 Spacebars， 是 Handlebars 的 直系 后 帘 ， 与 其 共享 大 部 分 语法 和 


功能 。 


Blaze 采 用 实时 页 面 更 新 ， 所 以 每 当 服 务 器 上 模板 相关 的 文件 (HTML、CSS 或 者 JavaScript ) 
有 改动 时 ， 浏 览 器 会 即时 更 新 。Blaze 是 如 何在 项 目 中 找到 模板 的 呢 ? 


3.2.2 组织 模 板 文 件 


使 用 模板 时 ， 通 常 有 四 种 类 型 的 文件 需要 处 理 ， 虽 然 在 技术 上 一 个 模板 只 需要 一 个 文件 。 
口 存储 在 HTML 文 件 中 的 实际 模板 。 
口 JavaScript 文 件 中 的 可 选 JavaScript 代 码 。 该 文件 运行 在 客户 端 上 上 下文， 为 模板 提供 功能 。 
口 一 个 或 多 个 CSS 样 式 文件 "。 
口 可 选 的 静态 资源 ， 如 public 文 件 夹 中 的 图 像 或 字体 。 

没有 相应 的 JavaScript, 模板 只 能 是 静态 的 , 不 能 用 动态 的 内 容 填充 , 这 就 是 为 什么 在 大 多 数 
情况 下 ,要 使 用 模板 至 少 需要 两 个 文件 。 为 了 让 这 些 内 容 组 织 有 序 , 最 好 把 每 个 模板 放 在 一 个 专 
门 的 HTML 文 件 中 。Meteor 会 在 项 目 文 件 夹 的 任何 地 方 找到 它们 ”*。 所 有 的 前 端 代码 都 可 以 存储 
在 一 个 单独 的 JavaScript 文 件 中 ， 或 者 使 用 HTMLAS 对 ， 这 样 每 个 模板 包括 两 个 文件 ， 如 果 你 的 
项 目 变 得 越 来 越 复 杂 ， 我 们 建议 你 这 样 做 : 

<template name>.js 

<template name>.html 


在 这 一 章 中 ,我 们 不 会 关注 元 素 的 样式 ， 因 为 这 和 任何 其 他 Web 应 用 一 样 。 我 们 在 上 一 章 中 
提 到 了 public 文 件 夹 ， 所 以 这 里 只 专注 前 两 个 元 素 : HTML 和 JavaScript 文 件 。 


3.3 创建 动态 HTML 模板 


Meteor 有 自己 的 模板 语言 ， 即 Spacebars。 如 果 熟 悉 Handlebars 或 Mustache， 你 已 经 有 足够 知 
识 来 马上 使 用 它 了 。 即 使 没有 使 用 过 这 些 语言 ， 你 也 会 发 现 它 的 常用 语法 相当 简单 。 

用 Spacebars 写 的 模板 看 起 来 就 像 普通 的 HTML。 模 板 标签 很 容易 发 现 ,因为 它们 总 是 被 封装 
在 多 个 大 括号 中 。 四 种 主要 的 模板 标签 类 型 如 下 所 示 。 




































































口 双重 大 括号 标签 {{ ... }} 

口 三 重大 括号 标签 {{{ ... }}} 

口 包含 标签 {{> ... }} 

口 块 标签 {{#directive}} ... {{/directive}} 

















人 另外 ，Less、Sass 等 样式 语言 也 可 以 使 用 ，CSS 只 是 一 个 例子 。 
@) 这 条 规则 有 例外 ， 我 们 将 在 第 10 章 深入 探讨 。 
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3.3.1 ”双重 和 三 重大 括号 标签 (表达 式 ) 


模板 标签 可 以 通过 动态 生成 的 内 容 来 奉 换 ， 进 而 改进 静态 的 HTML 代 码 。 模 板 标 签 也 被 称 为 
表达 式 ( expression )。 它 们 依赖 于 一 个 数据 源 或 返回 一 个 值 的 某 种 应 用 逻辑 。 
模板 标签 只 能 在 模板 上 下 文中 使 用 。 下 面 的 代码 清单 中 显示 了 一 个 基本 的 模板 标签 。 


代码 清单 3-2 双重 大 括号 模板 标签 


<template name="expressions"> 
{{ name }} 
</template> 


正如 你 所 看 到 的 ， 每 个 模板 都 包含 <template> 的 开始 和 结束 标签 以 及 强制 性 的 name 属 性 。 
在 应 用 程序 的 模板 中 ， 这 个 name 属 性 是 唯一 的 标识 符 。 可 以 在 JavaScript 文 件 中 使 用 模板 的 名 称 
来 访问 模板 ， 我 们 会 在 后 面 做 这 件 事 请 。 

1. 双重 大 括号 标签 

双重 大 括号 模板 标签 用 来 把 字符 串 搬入 到 HTML。 不 管 它们 处 理 的 返回 值 是 数组 、 对 象 或 字 
符 串 , 它 总 是 被 呈现 为 一 个 字符 串 。 假设 你 有 个 如 代码 清单 3-2 所 示 的 名 为 expressions 的 模板 ， 
现在 要 使 用 <strong>Michael</strong> 来 替换 模板 标签 1{ name }}。 

相应 的 JavaScript 代 码 必 须 返 回 赫 换 字符 串 ， 如 代码 清单 3-3 所 示 。 请 记 住 ， 代 码 必须 放 在 
Meteor .isclient 的 环境 下 ， 它 不 能 在 服务 器 端 运行 ， 因 为 模板 在 服务 器 环境 下 是 不 可 用 的 。 


代码 清单 3-3 name 辅助 函数 的 JavaScript 代 码 



































if (Meteor.isClient) { < 一 
Template.expressions.helpers({ 此 模板 只 能 用 于 客户 端 ， 
name: function () { 在 服务 器 上 未 定义 


return "<strong>Michael</strong>"; 
} 
车 了 
} 


以 上 的 HTML 和 JavaScript 代 码 一 起 ， 产 生 的 效果 如 图 3-3 所 示 。 








®@ ® / 四 3.3 Creating dynamic 
Eg (oy localhost:3000 


<strong>Michael</strong> 





图 3-3 ”双重 大 括号 标签 在 演 染 中 会 对 HTML 和 脚本 标签 做 转 义 处 理 


正如 你 看 到 的 ,双重 大 括号 会 处 理 字 符 串 ,并 转 义 所 有 可 能 不 安全 的 字符 。 如 果 你 想 避 免 返 
回 值 被 意外 解释 为 HTMIL 或 JavaScript， 这 是 很 有 用 的 。 然 而 ， 有 时 你 可 能 希望 避免 任何 字符 串 处 
理 。 在 这 种 情况 下 ， 需 要 使 用 三 重大 括号 。 

2. 三 重大 括号 标签 

如 果 模 板 标签 由 三 重大 括号 {{{ ... }}} 开 始 和 结束 ， 它 呈现 的 内 容 就 和 你 传递 给 模板 标 
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签 的 一 样 。 作 为 代码 清单 3-3 示 例 的 扩展 ， 让 我 们 现在 使 用 {{{ name }}} 而 不 是 {{ name }}。 
Meteor 将 不 会 转 义 任何 字符 或 标签 ， 输 出 到 浏览 器 的 内 容 不 变 (参见 图 3-4 )。 





I@ee®@e®@ \ 
li J 四 3.3 Creating dynamic HTM x NR _ | 
Ii€3 CC | localhost:3000 


Double curly braces 


<strong>Michael</strong> 





| Triple curly braces 


Michael 


| Q IElements| Network Sources Timeline 
产 <head>..<7head> 
了 <body> 
| <h3>Double curly braces</h3> 
"<strong>Michael</strong>" 
<h3>Triple curly braces</h3> 
<strong>Michael</strong> 


图 3-4 三 重大 括号 中 的 字符 串 将 呈现 为 HTML 标签 














你 可 以 看 到 ，HTML 标签 呈 现 为 DOM 中 的 HTML ， 而 不 是 简单 的 字符 串 。 


警告 如 果 使 用 三 重大 括号 显示 用 户 和 输入 的 数据 ， 你 必须 确保 它 是 经 过 消毒 的 ( 即 ， 检 查 潜在 的 
恶意 脚本 内 容 )。 如 果 不 这 样 做 ， 你 的 网 站 将 很 容易 受到 跨 站 脚本 攻击 。 处 理 用 户 生成 数 
据 最 简单 的 方法 是 在 数据 显示 之 前 让 Meteor 帮 你 消毒 ， 并 尽 可 能 地 坚持 使 用 双重 大 括号 。 


管 帘 Blaze 的 构建 时 编译 器 : 把 HTML 变 为 HTMLJS 
Blaze 使 用 它 的 运行 时 API 将 HTML 代 码 从 Spacebars 模 板 变换 为 JavaScript。 每 个 编译 过 的 模 
板 文 件 可 以 在 目录 .meter/local/build/programs/web.browser/app 中 找到 。 


代码 清单 3-2 中 的 模板 将 产生 以 下 代码 : 


Template["expressions"] = new Template("Template.expressions", 
EGGOi NT 
NE 三 和 已 
return [ HTML.Raw( Blaze.View 在 名 为 expressions 
Bularmem vo loo me DOM 中 构建 一 的 模板 被 转换 为 
function() { 个 响应 式 区 域 一 个 函数 
return Spacebars.mustache(view.lookup ("name"));} 
) Spacebars 返 回 
name 的 实际 值 


这 段 HTMLJS 代 码 使 Meteor 能 够 响应 式 地 更 新 模板 甚至 是 其 中 一 部 分 。 每 个 模板 都 可 以 通 
过 全 局 Template 对 象 的 name 必 性 来 访问 。 
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虽然 有 可 能 从 一 个 模板 的 辅助 函数 中 直接 调用 Blaze.View， 但 很 少 需要 这 样 做 。 只 有 当 
你 决定 为 Blaze 建 立 自 己 的 运行 时 API， 把 Spacebars 替 换 成 其 他 的 模板 语言 ， 比 如 Jade 或 
Markdown 时 ， 你 才 需 要 熟悉 内 部 处 理 结构 。 

在 有 可 用 的 API 文 档 之 前 ， 你 可 以 通过 查看 blaze 和 Spacebars 包 的 内 容 来 了 解 更 多 的 信 
息 ， 这 两 个 包 是 Meteor 核 心 的 一 部 分 。 


3.3.2 包含 标签 〈 局 部 模板 ) 


除了 捅 和 人 字符 串 或 HTML， 还 可 以 把 一 个 模板 搬入 到 另 一 个 模板 。 因 为 它们 只 占 整个 模板 的 
一 部 分 ， 所 以 这 些 子 模板 也 被 为 局 部 模板 (partials )。 要 将 模板 插入 到 另 一 个 模板 ， 在 两 个 大 括 
号 中 间 使 用 > 符号 : 

{{> anotherTemplate }} 

包含 标签 是 一 个 重要 的 工具 ， 能 使 单个 模板 变 小 ， 并 且 只 代表 一 件 事 。 如 果 你 想 泻 染 一 个 
复杂 的 用 户 界 面 ， 我 们 建议 你 将 所 有 用 户 可 以 看 到 的 部 分 分 成 更 小 的 、 逻 辑 上 封装 好 的 模板 和 
子 模板 。 

1. 整体 式 模板 

例如 ， 你 需要 一 个 个 人 信息 页 面 ， 不 仅 要 显示 一 个 人 的 头像 和 名 字 ， 还 要 包括 一 个 新 闻 流 。 
你 可 以 把 这 一 切 变 成 一 个 模板 ， 如 下 面 的 代码 清单 所 示 。 


代码 清单 3-4 配置 页 面 的 整体 模板 
<template name="partials"> 


<div class="]eft"> 
<img src="{{image}}"> 





















































该 模板 代表 部 分 
4 |] 把 这 个 div (paritials) 页 面 


<p>{{name}}</p> 放 在 左 侧 
</div> 
<div class="right"> | 把 这 个 div 
<ul class="news-stream"> | 放 在 右 侧 


<11 class="news-item">Yesterday I went fishing, boy this was a blast</1i> 
<11 class="news-item">Look, cookies! <img src="cookies.jpg"></1i> 
UES 
</div> 
</template> 


如 果 用 户 界 面 变 得 更 加 复杂 , 可 以 想象 个 人 信息 模板 可 能 会 变 大 。 这 对 代码 的 可 读 性 和 可 维 
护 性 都 不 好 。 最 好 把 所 有 的 东西 都 用 它 自 己 的 逻辑 功能 分 离 成 一 个 专用 的 模板 , 然后 把 它们 组 合 
在 一 个 主 模板 中 。 这 样 ， 你 的 模板 可 维持 小 的 规模 ， 也 更 容易 阅读 和 维护 。 两 个 开发 人 员 可 以 分 
别 进行 个 人 信息 和 新 闻 流 的 工作 ， 并 使 各 自 的 修改 更 加 容易 。 

2. 模块 化 的 模板 

代码 清单 3-5 显 示 了 我 们 的 第 一 个 模板 ，partialssplit。 这 是 代表 站 点 的 主 模 板 ， 包 含 两 
个 较 小 的 模板 。 两 个 小 的 模板 代表 实际 的 用 户 个 人 信息 (partialsUserProfile ) 和 新 闻 流 
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(partialsNewsStream)。 男 外 需 注 意 ， 布 局 包含 在 主 模板 partialssplit 中 ， 在 这 个 例子 中 


为 <div En class= "right"></div>。 


代码 清单 3-5 ” 拆 分 个 人 信息 页 的 模板 


<template name="partialsSplit"> 表示 个 人 信息 页 
<div class="left"> 的 模板 
ee < 用 户 个 人 信息 作为 子 模板 
<div class="right"> 包含 在 母 模板 中 
{{> partialsNewsStream}} 
</div> “新 闻 流 也 作为 子 模板 
</template> 包括 在 母 模 板 中 


<template name="partialsUserPprofile"> 
<img src="{{image}}"> 
<p>{{name}}</p> 

</template> 


<template name="partialsNewsStream"> 
<ul class="news-stream"> 
<li class="news-item">Yesterday I went fishing, boy this was a blast</1i> 
<11 class="news-item">Look, cookies! <img src="cookies.jpg"></1i> 
Ls 
</template> 


提示 请 避免 将 布局 信息 放 在 子 模 板 中 。 让 父 模板 定义 它们 所 包含 元 素 的 外 观 、 感 觉 以 及 大 小 。 


没有 布局 定义 的 子 模板 大 大 提高 了 可 重用 性 。 因 为 在 partialsUserProfile 模 板 中 没有 布 
局 定义 ， 所 以 你 很 容易 在 另 一 个 页 面 模板 中 重用 它 ， 比 如 像 这 样 把 它 放 在 右边 : <div class= 
"right">{{> partialsUserProfile }}</div>o 

3. 动态 包含 模板 

除了 使 用 静态 文本 包含 子 模板 , 你 可 以 基于 辅助 函数 返回 值 动态 地 包含 一 个 模板 ( 见 代码 清 
3 有 这 样 ， 你 可 以 响应 式 地 切换 模板 ， 而 不 用 在 模板 内 部 维护 复杂 的 if/else 结 构 。 结 合 会 话 
变量 这 样 的 响应 式 数 据 源 ， 动 态 模 板 相当 强大 。 


代码 清单 3-6 ”使 用 辅助 函数 动态 插入 子 模板 


// meteorTemplates.html 
<template name="dynamicPartials"> 
<div class="left"> 




















ts .dynamic template=templateNameLeft }} 该 子 模板 的 
: , 名 称 来 自 一 

<Llv elasss right ,> 个 辅助 函数 
{{> Template.dynamic template=templateNameRight }} 

</div> 


</template> 
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// meteorTemplates.js 
Template.dynamicPartials.helpers(t{ 











templateNameLeft: function () { 
return "partialsUserprofile"; 人 
) 辅助 函数 返回 
, 一 个 动 太 或 直 
templateNameRight: function () { | 动态 或 静 
. ; 和 态 的 字符 串 
return "partialsNewsStream"; 





} 
Dy 


3.3.3” 块 标签 


表达 式 或 局 部 模板 本 质 上 是 占 位 符 ， 而 块 标签 改变 了 封闭 HTML 块 的 行为 。 它 由 双重 大 括号 
和 # 开 始 。 一 个 块 模板 标签 看 起 来 是 这 样 的 : 


<template name="myTemplate"> 

















块 模板 标签 由 一 个 名 字 和 





{{#name arguments}} | 可 选 的 参数 开始 
<p>Some content</p> < 一 一 块 模板 标签 
oe 人] 必须 使 用 和 标签 开始 处 相同 ”的 内 容 
a 的 名 字 来 结束 该 块 模板 标签 











块 标签 不 仅 用 于 显示 内 容 , 还 用 于 对 模板 的 处 理 进行 控制 。 你 可 以 定义 自己 的 块 标签 或 使 用 
Spacebars 的 块 标签 。 
口 #if 一 一 如 果 条 件 为 真 ， 执 行 一 个 内 容 块 ， 否 则 执行 else 块 。 
D #unless 如 果 条 件 为 假 ， 执 行 一 个 块 ， 和 否则 执行 slse 块 。 
口 #with 一 一 设置 块 的 数据 上 下 文 。 
口 #each 多 个 元 素 的 循环 。 


1. if/unless 标 签 
if 块 标签 是 内 置 的 标签 之 一 。 它 和 JavaScript 中 通常 的 if 块 类 似 。 它 会 检查 一 个 条 件 ， 如 果 


它 的 值 为 true， 块 的 内 容 将 被 处 理 ， 即 它们 将 被 泻 染 。 任 何在 JavaScript 上 下 文中 被 认为 是 真 的 
值 也 将 会 被 #if 标 签 认 为 是 真 。 如 果 JavaScript 中 的 假 值 "， 如 nul1、unaefined、0、""( 空 字 
符 串 ) 或 false 被 传递 给 #if 块 ,下 面 的 块 将 不 会 被 泻 染 (参见 表 3-1 )。 代 码 清单 3-7 只 有 在 存在 
一 个 ijmage 辅 助 函数 ， 并 且 该 函数 求 值 为 Lrue 时 ， 才 显示 图 像 标 签 。 



















































































代码 清单 3-7 使 用 if 块 
<div class="cookies"> 
<p>Look, more cookies!</p> | ag 
{{#if image}} < | 则 该 <img> 标 签 就 会 
1 | 被 泻 染 
{{/if}} 


</div> 











mr 








值 (truthy )。 








Qa 任何 求 值 为 false 的 值 被 认为 是 假 值 (falsey )， 即 使 实际 值 不 是 false。 求 值 为 true 的 值 被 认为 是 
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表 3-1 输入 值 和 #if 求 值 的 结果 
输入 值 求 值 为 








false，0 ( 零 )，"" ( 空 字 符 串 ) ，nul1，undefinedq，NaN，[] ( 空 数组 ) false 
字符 串 (包括 "0")， 数 组， 对 象 (包括 空 对 象 ) 





可 





对 应 于 #if 块 标签 的 是 #unless 块 标签 。 只 有 当 条 件 求 值 为 false 时 , 它 才 会 处 理 块 内 容 ( 见 
下 面 的 代码 清单 )。 


代码 清单 3-8 使 用 unless 块 


<template name="unlessBlock"> 
{{#unless image}} 
<p>Sorry, no image available.</p> 


了 |] 如 果 image 求 值 


为 假 ，<p> 标 签 
{{/unless}} 将 被 泻 染 
</template> 


#:E 和 #unless 都 可 以 与 el se 标签 组 合 使 用 ,条件 为 真 时 泻 染 一 个 东西 ,条件 为 假 时 泻 染 另 
一 个 。 代 码 清单 3-9 使 用 了 #if， 但 它 的 工作 原理 和 #unless 是 一 样 的 。 


代码 清单 3-9 在 if 抉 中 使 用 else 


{{#if image}} 





























i nm 使 用 if 还 是 unless 决 
a 定 了 条 件 的 真 值 还 是 
<p>Sorry, no image available.</p> < 假 值 首先 被 处 理 


EE 如 果 {{image}} 返 回 一 个 假 值 ， 


<p> 标 签 将 会 被 泻 染 
说 明 不 存在 {{elseif}} 标 签 。 在 处 理 更 多 的 分 支 条 件 时 ， 你 需要 在 模板 中 使 用 谋 套 的 if-else 
结构 ， 或 者 最 好 能 够 调整 JavaScript 代 码 ， 让 它 可 以 代替 模板 处 理 更 多 的 逻辑。 


块 标签 和 模板 标签 必须 包括 有 效 的 HTML， 否 则 Meteor 会 过 到 错误 。 这 意味 着 你 必须 关闭 屠 
些 打开 的 标签 。 此 外 ， 在 一 个 块 内 打开 的 每 个 元 素 也 必须 在 该 块 中 关闭 。 你 不 能 在 一 个 # f 块 内 
包含 一 个 打开 的 <aiv> 标 签 ， 然 后 在 {felse)) 块 后 关闭 这 个 标签 ， 因 为 这 会 导致 演 染 时 产生 无 
效 的 HTML 页 面 。 如 果 模 板 中 有 错误 应 用 将 崩溃 并 产生 一 个 错误 消息 。 图 3-5 显 示 了 以 下 代码 块 
产生 的 错误 消息 。 


{{#if highlightBox}} 
<div class="box box-highlighted"> 














ee 这 是 不 允许 的 ， 因 为 它 不 是 
<div class="box "> 一 个 有 效 的 HTML 标 签 对 
/生生 A 疝 ， 了 
<p>Welcome!</p> 在 一 | 模板 中 ， 只 有 <div> 的 结束 


wai .| 标签 而 没有 开始 标签 是 不 允许 的 
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©00 / 四 localnoscsooo X ‘a wa 
€ SC |D localhost:3000 交 | 四 











Your app is crashing. Here's the latest log. 
=> Errors prevented startup: 
While building the application: 


simple.html:20: Unexpected {{else}} 
.ghted"> {{else}} <div class=... 


=> Your application has errors. Waiting for file change. 








图 3-5 “无效 HTML 模 板 的 输出 
在 HTML 属性 值 中 使 用 块 标签 是 完全 没有 问题 的 : 











<div class="box {{#if highlightBox}}box-highlighted{{/if}}"> < 
pe ee Sp> 如 果 highlightBox 是 真 值 ，box-highlighted 
Be 将 会 包含 在 类 的 属性 中 


2. each/with 标 签 

如 果 你 希望 将 多 个 值 传递 给 一 个 模板 , 最 常见 的 方法 是 使 用 数组 。 当 一 个 数组 传递 给 模板 时 ， 
可 以 使 用 #each 标 签 遍历 数组 的 内 容 。#each 以 一 个 数组 作为 参数 ， 并 为 数组 中 的 每 一 项 泻 染 它 
的 块 内 容 。 在 代码 清单 3-10 中 , ski11s 作 为 一 个 参数 传递 。 这 定义 了 所 谓 的 块 的 数据 上 下 文 ( data 
context )。 没 有 数据 上 和 下文，#each 将 不 会 泻 染 任何 东西 。 


代码 清单 3-10 ”使 用 #each 标 签 




















// HTML 文 件 
<template name="eachBlock"> 加 
#each 块 标签 需要 一 个 
<ul> 
台 为 参 
{{#each skills}} 数组 作为 参数 。 
<li>{{this}}</1i> < 一 
{{/each}} 
A 你 可 以 使 用 this 访 问 
</template> 数组 的 当前 对 象 
// JavaScript 文 件 
Template.eachBlock.helpers({ 
skills: function(){ 
return ['Meteor', 'Sailing', 'Cooking']; 


} 
}); 


#each 需 要 模板 有 数据 上 下 文 ，#with 人 允许 你 定义 数据 上 下 文 。 数据 上 下 文 提供 了 模板 和 任 
何 数 据 之 间 的 实际 关联 。 

使 用 #with 标 签 设置 数据 上 下 文 需 要 一 个 属性 , 该 属性 将 成 为 下 面 块 的 数据 上 下 文 。 代 码 清 
单 3-11 示 例 中 显示 了 withBlock 模 板 的 数据 上 下 文 被 显 式 设置 为 profileJim。 
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代码 清单 3-11 使 用 #with 标 签 


// meteorTemplates.html 
<template name="withBlock"> 
<ul> 
{{#with profileJim}} < 一 profileJim 被 
<p>{ {name}}</p> 定义 为 数据 
{{#each skills}} 上 下 文 
<l1i>{{this}}</1i> 
{{/each}} 
{{/with}} 
/UES 
</template> 





// meteorTemplates.js 
Template.withBlock.helpers(t{ 


profileJim: function () { 
让 说 芽 前 营 , 六 
name: 'Uim "Sailor Ripley" Johnson ' ， 
skills: ['Meteor', 'Sailing', 'Cooking'], 


}; 
return jim; 
} 
oe 
没有 必要 显 式 指定 数据 上 下 文 , 可 使 用 辅助 函数 来 自动 提供 上 下 文 。 一些 更 高 级 的 用 例 要 求 
这 样 做 。 在 下 一 章 讨论 响应 式 数 据 源 时 ， 我 们 会 看 到 它们 。 
从 技术 上 讲 ， 所 有 内 置 的 块 标签 都 是 辅助 函数 。 让 我 们 看 看 如 何 创 建 自己 的 模板 辅助 也 数 。 


3.3.4 辅助 函数 


处 理 模板 时 ， 你 经 常会 发 现 需要 使 用 一 些 相同 的 功能 ， 比 如 把 时 间 格式 化 为 HH:MM:SS 格 式 
或 应 用 控制 结构 。 这 时 就 需要 使 用 辅助 函数 。 

缚 助 画 孝 是 JavaSeript 函 数 ,可 以 执行 任何 处 理 。 它们 可 以 被 限制 在 一 个 模板 中 或 在 全 局 范围 
内 使 用 。 全 局 模板 辅助 函数 可 在 所 有 的 模板 中 重复 使 用 , 把 它们 定义 在 一 个 专门 的 JavaSeript 文 件 
而 不 是 某 个 模板 的 JavaScript 文 件 是 个 很 好 的 做 法 。 

1. 局 部 模板 辅助 函数 

局 部 模板 畏 助 函数 只 用 于 扩展 一 个 特定 的 模板 。 它 不 能 在 其 他 模板 间 共 享 ,并 且 只 存在 于 特 
定 模板 的 命名 空间 中 。 局 部 模板 铺 助 函 数 最 简单 的 形式 看 起 来 类 似 于 表达 式 。 

每 个 Template 对 象 都 有 一 个 helpers 函 数 ， 它 需要 一 个 包含 多 个 键 值 对 的 对 象 作为 参 
数 。 通 常 ， 键 是 可 以 在 模板 中 使 用 的 占 位 符 名 称 ， 而 值 是 可 返回 值 的 函数 。 函 数 的 返回 值 不 
需要 是 一 个 字符 串 ， 它 可 以 是 任何 静态 值 ， 比 如 数字 、 数 组 、 对 象 ， 甚 至 是 一 个 可 返回 另 一 
个 值 的 函数 。 

为 了 简化 问题 ,我们 在 代码 清单 3-12 中 列 出 了 HTML 文 件 以 及 JavaScript 文 件 中 的 内 容 。 一 些 
铺 助 函数 只 返回 一 个 静态 值 ( name )， 其 他 的 则 返回 数组 ( skills )、 对 象 ( image ) 甚至 是 一 
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个 函数 (hasMoreskills )。 图 3-6 是 演 染 生成 的 HTML 代 码 。 


代码 清单 3-12 


// meteorTemplates.html 
<template name="localHelpers"> 
<p>{{name}}</p> 





使 用 不 同 局 部 辅助 函数 的 个 人 信息 模板 


访问 本 地 辅助 函数 name， 它 
返回 简单 的 字符 串 'Jim' 


4 


你 可 以 访问 对 象 的 值 ， 可 















































—> {{#if image}} 
图 像 是 一 <img src="{{image.thumb}}"> < 一 一 一 一 一 以 和 正常 的 JavaScript 一 
个 对 象 CC/ 样 使 用 点 操作 符 
此 是 一 个 {{#if skills}} < 一 一 
真 什 为 训 <p>Primary Skill: {{skills.[0]}}</p> 坷 一 如 果 数 组 是 空 的 ， 将 
; 2 {{#if hasMoreSkills skills}} 二 一- 会 泻 染 块 内 容 
人 <a href="/skills">see more...</a> 二 
现 ({/if}} 
A skills 是 一 个 数组 ， 你 可 以 通过 
</template> array.[index] 访 问 数组 中 的 一 个 值 
// meteorTemplates.js 
Template.localHelpers.helpers(t{ . 、 
name: 'UJim' ， 如 果 辅 助 函 数 hasMoreSkills 返回 
image: { true, #if 块 将 被 泻 染 。 在 这 种 情况 下 ， 
large: '/jim-profile-large.jpg', hasMoreSkills 有 个 skills 辅 助 函 数 作 
thumb: '/jim-profile-thumb.jpg' 为 参数 
5 
skills: ['Meteor', 'Sailing', 'Cooking'], 
hasMoreSkills: function (skills) { 如 果 有 skills 参 数 并 
return skills && skills.length > 1; < 一 且 有 超过 一 项 技能 ， 
} 则 返回 true 
}); 
Q |Elements| Network Sources Timeline 
| <p>Jim</p> 
<img src="/jim- = j pg"> 
"Primary Skill: " 
"Meteor" 
</p> 
<a href="/skills">see more..</a> 
</body> 上 
图 3-6 局 部 辅助 函数 生成 的 代码 
要 传递 参数 到 辅助 函数 ,在 辅助 子 数 后 ( 用 空格 隔 开 ) 简单 地 写 下 你 想 传递 的 参数 。 传 递 参 
数 的 顺序 与 函数 本 身 参 数 定义 的 顺序 相同 。 




















{{#if hasMoreSkills skills}} 


再 看 看 代码 清单 3-12。 内 置 的 辅助 函数 #i£ 对 以 下 表达 式 求 值 ， 以 确定 其 是 真 还 是 假 : 














在 这 种 情况 下 ， 它 检查 hasMoreSkills， 这 是 一 个 函数 ， 需 要 一 个 输入 值 。 因 此 ， 不 会 使 用 





if 后 面 跟 一 个 表达 式 的 标准 行为 ， 第 二 个 占 位 符 s 


递 给 hasMoreSkil1s 表 示 的 函数 。 如 果 某 人 有 多 个 技能 ， 它 会 返回 true， 这 样 1f 条 件 判 断 


kil1s 被 作为 参数 传递 。skil11s 对 象 的 内 容 传 


通过 。 





邮 
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2. 全 局 辅助 函数 

时 常 有 一 些 辅 助 函 数 不 只 在 一 个 模板 中 需要 , 但 你 只 想 写 一 次 。 比 如 说 ,你 想 创建 一 个 辅助 
函数 ， 如 果 一 个 数组 的 项 数 大 于 n 个 , 则 该 辅助 函数 返回 true。 让 我 们 将 这 个 辅助 函数 命名 为 gt 
( 即 greater than, 大 于 )。 因 为 这 个 辅助 函数 将 在 多 个 模板 中 使 用 , 所 以 可 创建 一 个 globalHelpers.js 
文件 ， 将 辅助 函数 的 代码 放 在 这 里 。 记 得 把 代码 包 在 一 个 if (Meteor.isclient) {...} 块 中 ， 
因为 辅助 函数 和 模板 一 样 ， 只 在 客户 端 范围 内 可 用 。 

因为 希望 新 的 辅助 函数 在 所 有 的 模板 中 都 可 以 使 用 ,所 以 不 能 使 用 Template .<template- 
Name> 来 定义 它 。 请 使 用 T mplate.registerHelper, 下 面 的 代码 清单 显示 了 如 何 组 合 使 用 局 
部 和 全 局 的 辅助 函数 。 


代码 清单 3-13 ”使 用 全 局 辅助 函数 来 确定 数组 长 度 


// meteorTemplates.html 
<template name="globalHelpers"> 



























































skills 包 含 三 个 项 目 ， 所 以 


{{#if gt skills 1}} -| 全 局 gt 辅助 函数 返回 true 
<a href="/skills">see more...</a> 
0 a images 只 包含 两 个 项 目 ， 
1 1 条 Eh zw 
<a href="/images">see more...</a> 全 局 gt 辅助 函数 返回 false 
{{/if}} 
</template> 


globalHelpers 模 板 
Jj | 的 局 部 辅助 函数 


// meteorTemplates.js 
Template.globalHelpers.helpers({ 





skills: function () { 
return ['Meteor', 'Sailing', 'Cooking']; 
} 
images: function () { 
return ['/jim-profile-large.jpg', '/jim-profile-thumb.jpg']; 
} 
上 让 
使 用 registerHelper 逊 
// globalHelpers.js 数 可 以 创建 在 所 有 的 
if (Meteor.isClient)t{ 模板 中 都 可 以 使 用 的 


Template.registerHelper('gt', function(array, n){ < 一 辅助 函数 
return array && array.length > n; 

} 

3. 自 定义 块 辅助 函数 

自 定义 块 辅助 函数 也 是 非常 有 用 的 , 它们 是 全 局 的 。 它们 允许 你 建立 可 重复 使 用 的 用 户 界 面 
组 件 或 部 件 。 请 注意 ， 即 使 没有 任何 JavaScript， 实 际 的 辅助 函数 也 可 能 被 用 到 。 

假设 你 定义 了 一 个 新 的 块 辅助 函数 #siqebarwidget , 你 还 需要 定义 一 个 具有 相同 名 称 的 模 
板 。 块 辅助 函数 被 调用 时 ， 该 模板 将 被 注入 。 在 模板 内 部 ， 使 用 局 部 模板 语法 包含 remplate. 
contentBlock 的 输出 。 你 也 可 以 从 传递 给 该 块 辅助 函数 的 数据 上 下 文中 访问 任何 其 他 元 素 。 这 
个 例子 将 制作 带 有 标题 和 一 些 内 容 的 侧 边 栏 小 工具 。 

当 #sidepbarwiqdget 在 一 个 模板 中 被 调用 时 , 它 通 过 包含 Template .contentBlock 的 方式 
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将 自己 的 内 容 放 在 {{#sideparwidget }} 和 {{/sideparwidget }} 标 签 之 间 。 代 码 清 单 3-14 
有 实 上 ， 它 的 可 重用 性 使 它 非常 适合 构 


说 明 sidebarwiqdget 怎 样 用 来 在 某 个 模板 中 包 块 内 容 。 


建 用户 界 面 组 件 或 部 件 。 


山中 











在 一 个 应 用 的 body 中 添加 {{> coderofTheMonth }}, 创建 的 输出 如 图 3-7 所 示 。 
代码 清单 3-14 使 用 template-contentBlock 的 自 定义 块 辅助 函数 


<template name="coderOfTheMonth"> 





























{{# sidebarWidget title="Coder of the month"}} < 
-> Manuel 
{{/sideparWidget}} 可 以 为 自 定义 
</template> 块 辅助 函数 设 
这 是 需 置 数据 上 下 文 
要 显示 <template name="sidebarWidget"> 
的 内 容 <div class="sidebar-widget box"> < 
<div class="title">{{ this.title }}</div> 
<div class="content"> 
= {{> Template.contentBlock}} 
</div> 
</div> 
</template> 
Q  lElements| Network Sources Timeline Profiles Resc 
v <div id="sidebar"> 
v<div class="sidebar-widget box"> 
<div class="title">Coder of the month</div> 
Y<div class="content"> 
Manuel 
</div> 
</div> 
| </div> 
html body div.container div#sidebar MARTTI:F TT 
图 3-7 使 用 自 定义 块 辅助 函数 ， 可 以 在 可 重用 的 用 户 界面 组 件 或 部 件 中 包含 任何 内 容 















































除了 Template.contentBlock 以 外 ,还 有 一 个 Template.elseBlock( 见 代码 清单 3-15 ) 








可 用 于 { {else}} 模 板 标 签 后 的 内 容 块 。 这 样 ， 可 以 使 


代码 清单 3-15 ”使 用 template-elseBlock 


// meteorTemplates.html 





用 简单 的 控制 结构 来 增强 块 辅 助 子 数 。 


<template name="templateElseBlock"> 这 个 块 辅助 函数 名 为 isFemale, 我 们 


{{#isFemale gender}} 


传 给 它 一 个 gender 参 数 , 该 参数 来 自 


Mrs. 模板 辅助 函数 
{{else}} 
Mr. 
{{/isFemale}} isFemale 辅 助 函数 也 有 一 个 辅助 函数 
</template> eq，eq 接 受 两 个 参数 ， 它 检查 这 两 个 
参数 是 否 相 等 。 这 里 ， 它 涉及 gender 
<template name="isFemale"> 参数 
{{#if eq this 'w'}} 
{{> Template.contentBlock}} 4 


如 果 性 别 是 'w'， 那 么 #if 语 句 


为 真 , contentBlock 将 被 泻 染 
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{{else}} 
{{> Template.elseBlock}} 
人 兴工 在 于 于 
</template> 


// meteorTemplates.js 


如 果 不 是 ， 那 elseBlock 将 被 泻 染 。 
为 性 别 是 'm'， 所 以 elseBlock 将 被 


> 宇 > 
泻 染 


Template.templateElseBlock.helpers({ 


gender: function 
return 'm' 
} 
je 


QO: 苹 


Template.isFemale.helpers({ 
eq: function (a, b) { 
return a 
} 
A 


4. 把 逻辑 移动 到 辅助 函数 


isFemale 块 辅助 函数 也 有 一 个 辅助 函数 

eq，eq 接 受 两 个 参数 ， 它 检查 这 两 个 参 

数 是 否 相 等 。 在 这 种 情况 下 , 它 涉及 性 别 
二 | 参数 


























使 用 辅助 函数 返回 应 该 渲染 的 值 通 




















常 是 动态 显示 内 容 的 好 方法 。 模板 中 存在 的 逻辑 越 少 , 就 











越 容易 扩展 应 用 、 解 决 应 用 中 的 问题 。 








如 果 不 需要 在 不 同情 况 下 使 用 不 同 的 HTML 代 码 , 最 好 是 定义 一 个 











骨 助 函数 来 计算 要 显示 的 





正确 内 容 。 这 样 ， 你 就 可 以 避免 在 模板 中 使 用 #if 和 #unless。 代 码 清 单 3-16 使 用 模板 
logicByHelper 显 示 基 于 存储 在 数据 库 中 的 单字 符 性 别 值 的 正确 称呼 。 所 有 的 处 理 都 是 由 辅助 








函数 完成 的 ， 而 不 是 模板 本 身 。 











代码 清单 3-16 ”把 逻辑 从 模板 移动 到 JavaScript 辅 助 函 数 


// meteorTemplates.html 
<template name="logicByHelper"> 
{{genderLabel gender}} 


在 双重 大 括号 标签 中 , 我 们 调用 
二 | 辅助 函数 genderLabel， 传 递 


</template> gender 参 数 给 它 
// meteorTemplates.js 
Template.logicByHelper.helpers ({ 
gender: 'm', 
genderLabel: function (gender) { < 一 
if (gender === 'm') { 在 这 种 情况 下 , genderLabel 
return ‘Mr.'; 辅助 函数 返回 “Mr”， 因 为 
} else { 性 别 的 值 是 m 


return. Mrs 
} 
} 
}); 


正如 你 所 看 到 的 , 你 可 以 为 一 个 模板 定义 很 多 不 同 的 辅助 函数 ,它们 可 以 是 静态 值 ,甚至 是 





一 些 用 于 计算 返回 值 的 函数 。 














你 已 经 学 会 了 如 何 使 用 Spacebars 创 建 和 扩展 模板 , 很 容易 在 最 后 生成 一 些 HTML。 现在 你 知 
道 了 如 何 创建 应 用 程序 的 HTML 代 码 ， 让 我 们 用 事件 来 使 用 户 能 够 与 演 染 的 HTML 进 行 交互 。 
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3.4 ”处 理事 件 


静态 站 点 和 Web 应 用 之 间 的 主要 区 别 之 一 是 Web 应 用 人 允许 用 户 交 互 。 它 们 需要 处 理事 件 ， 如 
按钮 单 击 并 对 此 作出 响应 。 大 多 数 时 候 ， 响 应 基本 上 是 以 DOM 的 修改 来 显示 对 用 户 有 用 的 东西 。 
要 做 到 这 一 点 ， 必 须 有 一 种 方法 来 做 以 下 两 件 事 : 

口 定义 应 用 需要 监听 的 事件 ; 

口 定义 由 事件 触发 的 动作 。 

Meteor 使 用 事件 映射 来 定义 事件 和 它们 的 动作 。DOM 事 件 和 CSS 选 择 器 可 一 起 使 用 , 用 以 指 
定 哪些 元 素 和 事件 需要 监听 。 虽 然 你 可 以 在 事件 映射 中 使 用 任何 DOM 事 件 ， 但 它们 的 行为 可 能 
因 浏览 器 的 不 同 而 不 同 ， 表 3-2 中 列 出 的 事件 在 所 有 主要 浏览 器 上 都 应 该 有 相同 的 行为 。 


表 3-2 ”在 所 有 主要 浏览 器 中 工作 的 事件 类 型 


十 
蒂 
荡 

































































事件 类 型 用 于 
单 击 (click) 鼠标 单 击 任何 元 素 ， 包 括 链接 、 按 钮 或 aiv 
双击 (dblclick) 使 用 鼠标 双击 























焦点 (focus), 模糊 (blue) ”文本 输入 框 或 其 他 表单 控件 获得 或 失去 焦点 。 拥 有 tabingex 属 性 的 任何 元 素 被 认为 
是 可 获得 和 失去 焦点 的 

















改变 (change) 复 选 框 (check box) 或 单 选 按钮 (radio button) 的 状态 更 改 
MouseEnter, MouseLeave 鼠标 旨 针 进入 或 离开 元 素 

MouseDown, MouseUp 按 下 和 释放 鼠标 按钮 

KeyDown, KeyPress, KeyUp 上 压 下 或 释放 键盘 上 的 键 ，KeyDown 和 KeyUp 大 多 用 于 修改 键 ， 比 如 Shift 








3.4.1 模板 的 事件 映射 
每 个 模板 都 有 自己 的 事件 映射 。 它 在 类 似 于 下 面 的 JavaScript 文 件 中 定义 。 


代码 清单 3-17 ”布局 模板 的 事件 映射 
每 个 模板 都 有 一 个 








事件 函数 , 它 以 事件 该 对 象 的 值 是 一 
if (Meteor.isClient) { 映射 对 象 为 参数 个 函数 ， 该 函数 
Tempblate.1layout .events({ < 在 按钮 被 点 击 时 
:click button': function (event, template) { 被 调用 。 此 事件 
$s('body') .css('background-color', 'red'); 二 下 处 理 程 序 将 事件 
了 在 本 对 象 本 身 作为 第 
个 元 素 'mouseenter #redButton': function (event, template) { < 一 个 参数 ， 模 板 
上 触发 // 开始 动画 实例 作为 第 二 个 
什么 事 ) 把 鼠标 指针 移动 到 ID 为 | | 倒数 
件 下 redButton 的 元 素 上 可 
} 能 会 开始 一 个 动画 

















Meteor 使 用 jQuery 调用 实际 的 事件 处 理 函 数 。 在 这 个 例子 中 , 如 果 用 户 在 layout 模 板 中 单 击 
任何 按钮 ， 相 应 的 事件 处 理 程序 就 会 被 调用 ， 并 将 该 主体 (body ) 的 背景 色 设 置 为 red。 单 击 
layout 模 板 以 外 的 任何 按钮 不 会 触发 该 动作 ,因为 相关 的 事件 映射 只 跟 1ayout 模 板 内 部 的 东西 




















3.4 ”处 理事 件 59 








都 有 关联 。 但 是 ， 如 果 我 们 使 用 了 子 模板 ， 并 发 送 一 个 事件 ,会 发 生 什 么 呢 ? 根 据 代码 清单 3-18 
修改 代码 ， 并 单 击 任 一 按钮 来 看 一 看 。 


代码 清单 3-18 ”监听 子 模板 中 的 事件 





// meteorEvents.html 
<body> 
{{> layout}} 
</body> 
<template name="l]layout"> 





<button>Turn red</button> 单 击 该 按钮 将 使 body 元 素 
{{> green }} 的 背景 颜色 变 为 红色 ， 
</template> 为 在 绿色 人 处理 程序 执行 
后 , 也 会 调用 布局 (layout) 
<template name="green"> 模板 的 事件 处 理 程序 


<button id="green">Turn green</button> 
</template> 
// meteorEvents.js 
Template.layout.events(t{ 
'click putton': function (event, template) { 
$s('body').css('background-color', 'red'); 
} 
je 
Template.green.events({ 
'click button': function(event, template) { 
$s('body').css('background-color', 'green'); 
上 
把 


即使 我 们 有 两 个 不 同 的 事件 映射 和 两 个 按钮 , 在 更 新 的 代码 中 单 击 任何 一 个 按钮 都 将 把 背景 
变 为 红色 ， 甚 至 是 单 击 Turn Green ( 变 绿 ) 按钮 。 为 什么 呢 ? 


3.4.2 事件 传播 


你 在 这 里 看 到 的 现象 被 称 为 事件 传播 (event propagation ), 或 事件 冒 泡 (eventbubbling )。 这 
意味 着 每 个 事件 都 是 在 发 生 的 地 方 先 进行 处 理 ， 然 后 再 沿 着 DOM 树 向 上 传递 。 在 传递 时 可 能 会 
触发 另 一 个 行为 。 

在 最 好 的 情况 下 ， 你 可 以 巧妙 地 利用 这 个 链 ; 在 最 坏 的 情况 下 ， 如 这 个 例子 所 示 ， 你 想 要 采 
取 的 行为 被 另 一 个 行为 所 覆盖 。 









































说 明 事件 传播 时 ,可 能 会 有 意 想 不 到 的 副作用 。 记 得 阻止 它 ， 否则 它 会 沿 着 DOM 树 冒 泡 上 传 。 





正如 你 在 图 3-8 中 看 到 的 ， 有 三 个 模板 实例 : body 、layout 和 green。 如 果 用 户 单 击 
<button>Turn green</button>，green 模 板 的 事件 监听 器 被 调用 ， 因 为 它 监听 其 模板 范围 
内 的 按钮 单 击 。 这 样 发 生 第 一 个 动作 ， 设 置 bodqy 的 background-color 属 性 为 grzeen。 但 事件 
传播 还 没有 完成 。 
































事件 :没有 事件 监听 
动作 :没有 动作 定义 
本 


























































































































事件 向 上 传播 teemlplate mame= leaveat 
事件 : 单 击 2. 动作， 
动作 : 设置 background-color=red 红色 背景 
本 
Rr 件 向 上 传播 template name="green" 
件 : 单 击 1 动作 : 
动作 : 设置 background-color=green 绿色 背景 
图 3-8 green 模板 中 单 击 的 行为 序列 











事件 向 上 传递 给 layout 模 板 ， 它 也 会 作用 于 该 单 击 事件 。 它 调用 自己 的 事件 处 理 程序 。 然 
后 ， 第 二 个 动作 发 生 ， 它 设置 background-color 的 属性 为 红色 。 

技术 上 说 ， 只 要 事件 向 上 传播 ,绿色 背景 色 就 只 会 存在 一 个 短暂 的 时 间 。 因 此 ，green 模 板 
的 事件 处 理 程序 没有 看 得 见 的 效果 。 

最 后 , 事件 被 传递 给 body 元 素 , 如 果 它 有 一 个 定义 的 事件 映射 , 它 甚至 可 能 触发 第 三 个 动作 。 

如 果 不 希 望 多 个 模板 来 处 理 一 个 事件 ,你 可 以 , 也 应 该 ， 总 是 终止 事件 传播 。 在 模板 的 事件 
映射 中 添加 stopImmediatePropagation() 来 阻止 事件 党 DOM 冒 泡 。 按 照 下 面 代码 清单 中 的 代 
码 来 修正 green 模 板 中 的 事件 映射 。 


代码 清单 3-19 在 事件 映射 中 停止 事件 传播 
Template.green.events({ 
'click putton': function(event, template) { 
event .stopImmediatePropagation(); < 一 这 将 阻止 事件 
$s('body').css('background-color', 'green') 沿 DOM 冒 泡 
} 
} 
现在 单 击 按钮 ， 背 景 颜色 将 变 成 绿色 ， 无 论 layout 模 板 是 否 也 在 监听 按钮 点 击 。 如 果 想 对 
事件 处 理 有 更 多 的 控制 , 你 也 可 以 调用 evt .stopPropagation()。 这 样 做 不 会 阻止 其 他 事件 处 
理 程序 的 执行 ,但 如 果 你 喜欢 ,你 可 以 调用 evt.isPropagationsStopped() 来 检查 
stopPropagation() 是否 在 事件 链 的 某 个 地 方 被 调用 。 使 用 这 种 技术 , 你 可 以 向 bodqy 添 加 一 个 
事件 处 理 程序 来 对 green 模 板 和 body 中 的 点 击 作出 响应 ， 但 不 会 触发 layout 的 事件 处 理 程序 。 


3.4.3 ”阻止 浏览 器 的 默认 行为 


在 许多 情况 下 , 你 也 要 阻止 浏览 器 的 默认 事件 处 理 。 例 如 ， 如 果 你 单 击 一 个 正常 的 链接 ( <a 
href="url">Go To</a> )， 浏览 器 将 打开 <a> 元 素 hnref 属 性 指定 的 页 面 并 重新 加 载 页 面 。 在 使 
用 Meteor 构 建 的 应 用 中 ,， 你 当然 不 希望 浏览 器 在 任何 时 候 重 新 加 载 页 面 。 为 了 防止 这 一 点 ， 你 可 
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以 调用 event .preventDefault () ( 见 代码 清单 3-20 ) 来 阻止 浏览 器 的 默认 行为 。 
代码 清单 3-20 ”阻止 浏览 需 的 默认 行为 


Template.1ayout .events ({ 





'click a': function(event, template){ | 防止 浏览 器 执行 
event .preventDefault (); i 默认 操作 ， 即 跟 
console.log('Please do not leave yet'); 踪 链接 


} 
}); 


在 继续 了 解 如 何 将 数据 集成 到 模板 中 之 前 ， 我 们 需要 介绍 的 最 后 一 个 主题 是 模板 生命 周期 。 


3.5 ”模板 生命 周期 


将 模板 放 进 DOM， 使 它 对 用 户 可 见 ， 这 仅仅 是 其 生命 周期 的 一 部 分 。 为 了 在 浏览 器 中 呈现 
出 来 ， 每 个 模板 都 要 经 过 三 个 步 又 ( 图 3-9 )。 每 个 步骤 都 有 一 个 相关 的 回调 函数 ， 这 可 用 来 添加 
自 定 义 行 为 。 


























onCreated 回 调 函 数 onRendered 回 调 国 数 onDesttroyed 回 调 国 数 


En 


“模板 实例 可 访问 “模板 实例 可 访问 “模板 实例 不 再 访问 
“模板 不 可 见 “模板 在 浏览 器 中 可 见 “模板 不 再 可 见 


3-9 ”模板 生命 周期 


把 模板 插入 到 DOM 的 第 一 步 称 为 created。 虽 然 实际 的 模板 还 不 可 见 ， 但 是 模板 实例 已 经 
可 以 访问 了 。 相 关 的 回调 函数 是 oncreated, 如 有 果 要 在 模板 演 染 和 对 用 户 可 见 之 前 , 为 模板 实例 
初始 创建 一 些 属性 , 这 个 函数 是 非常 有 用 的 。 你 在 oncreated 回 调 函 数 中 设置 的 所 有 属性 都 可 在 
其 他 生命 周期 的 回调 函数 中 使 用 。 你 甚至 可 以 在 辅助 函数 和 事件 处 理 程序 中 使 用 它们 。 要 在 辅助 
函数 或 者 事件 处 理 程序 中 访问 模板 实例 ， 可 使 用 Template.instance()。 













































































说 明 正如 你 在 第 2 章 看 到 的 , 使 用 template.$() 或 template.find() 可 以 把 jQuery 的 范围 限 
制 在 当前 模板 实例 及 其 子 模板 中 。 


模板 的 第 二 状态 称 为 rendered。 相 关 的 回调 函数 是 onRendered， 它 可 用 来 初始 化 已 经 在 
DOM 中 的 对 象 。 典 型 的 例子 是 jQuery 的 插件 ， 比 如 日 期 选择 硕 ( datepicker )、 日历 (calendar ) 或 
日 期 表格 ( datetable )。 它们 需要 一 个 演 染 的 DOM 元 素 , 如 代码 清单 3-21 所 示 , 它们 在 onRendered 
回调 函数 中 进行 初始 化 。 在 这 里 ， 我 们 扩展 formTemplate 内 部 所 有 类 为 .aateinput 的 元 素 ， 
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为 其 增加 一 个 日 期 选择 器 "。 
代码 清单 3-21 初始 化 jQuery 插件， 在 输入 元 素 上 创建 一 个 datepicker 


Template.formTemplate.onRendered(function() { 
Var templateInstance = this; 


templateInstance.$('.dateinput') .datepicker({ 
// 其 他 选择 

3 
用 
第 三 个 回调 函数 是 onDestroyed， 用 于 清理 在 模板 生命 期 中 设置 的 任何 东西 。 它 执行 以 后 

模板 实例 将 不 可 见 也 不 可 访问 。 

这 三 个 回调 函数 只 执行 一 次 ， 不 会 重复 调用 ， 即 使 页 面 上 的 数据 发 生 了 变化 。 
让 我 们 考虑 一 个 简单 的 场景 ， 其 中 有 一 个 占 位 符 表达 式 : 


























<body> 
{{> profile}} 

</body> 

<template name="profile"> 你 可 以 像 这 样 在 
{{!-- demonstrating the lifecycle --}} 模板 中 使 用 注释 


<p>{{placeholder}}</p> 
<button>Button</button> 
</template> 


代码 清单 3-22 在 模板 生命 周期 的 每 个 阶段 中 添加 一 个 显 式 的 回调 函数 。 当 profile 模 板 创建 
时 ， ne 将 其 设置 为 createdq， 然 后 在 JavaScript 控 制 台 
打印 这 个 对 象 。 这 里 ， 你 已 经 可 以 读 取 模 板 的 数据 上 下 文 了 。 在 onRendered 回 调 函 数 中 ， 把 
lastCcallback 值 改 为 rendered。 使 用 Template.instance() ， 辅 助 浮 数 可 以 读 取 
lastCallback 的 值 , 而 且 单 击 按钮 可 以 更 新 它 的 值 。onDestroyeq 回 调 函数 在 浏览 器 控制 台中 
是 观察 不 到 的 。 所 有 控制 台 消息 如 图 3-10 所 示 。 


代码 清单 3-22 ”模板 生命 周期 的 回调 函数 

















Template.profile.onCreated(function () { 
this.lastCallback = 'created'; 
console.log('profile.created', this); < 
有 
Template.profile.onRendered(function () { 打印 个 人 信息 模板 的 实例 。 你 可 
this.lastCallback = 'rendered'; 以 像 this.foo='bar 这样 设置 模 
console.log('profile.rendered', this); < |] 板 实例 的 变量 。 这 个 变量 后 面 就 
}); 可 以 使 用 了 ,你 还 可 以 读 取 数据 
Template.profile.onDestroyed(function () { 上 下 文 ， 但 无 法 设置 它 
this.lastCallback = 'destroyed'; 
console.log('profile.destroyed', this); < 





}); 
Template.profile.helpers({ 











要 实际 使 用 datepicker， 你 还 需要 在 项 目 中 添加 所 需 的 datepicker 库 。 

















placeholder: function () { 
console.log('profile.placeholder', this); < 
console.log('profile.tplIinstance', 
Cs Template.instance().lastCallback); 只 打 E 
你 仍然 可 以 return 'This is the {{placeholder}} helper'; 只 打 数据 
上 下 文 。 你 
在 模板 辅助 法 通过 
< }); 无 法 通过 
函数 和 事件 ; this 访 问 模 
中 访问 模板 | Template.profile.events({ [| 天 
实例 'click button': function (event, template) { 板 实 例 
L> Template.instance().lastCallback = 'rendered and clicked'; 
console.log('profile.clicked', this); < 一 
console.log('profile.clicked.tplInstance', template); 二 二 
} 
在 事件 处 理 程序 中 你 不 需要 


) ) ; Template.instance()， ds 


会 作为 第 二 个 参数 直接 传递 过 去 


Q Elements Network Sources Timeline Profiles Resources Audits |Gonsole| 








© 可 <topframe> v 门 Preserve log 


profile.created 
Vv Blaze.TemplateInstance {view: Blaze.View, data: null, firstNode: null, lastNode: null, 
lastCallback; "created".} 
data: null 
Pp firstNode: h1 
lastCallback: "rendered" 
Pp lastNode: button 
bp view: Blaze.View 
pb__proto_: Blaze.TemplateInstance 


profile.placeholder Object {} Section35,js?4417913ba495ac82c2645040a8eb2 
profile,.tplInstance created Section35,js?4417913ba495ac82c2645040a8eb2 


profile,.rendered 
Pp Blaze.TemplateInstance {view: Blaze.View, data: null, firstNode: hl, lastNode: button, 


lastCallback: "rendered"..} 
j0n35, 15?4417913ba495 
profile.clicked Object {} Section35,js?4417913ba495ac82c2645040a8eb2 


profile.clicked.tplInstance 
Pp Blaze.TemplateInstance {view: Blaze.View, data: null, firstNode: hl, lastNode: button, 


lastCallback: "rendered and clicked"..} 
section35, js?4417913ba495ac82c2645040a8eb2 


v 











图 3-10 ”模板 回调 函数 的 控制 台 消息 








3.6 总 结 


在 本 章 中 ， 你 已 经 了 解 到 : 

口 Meteor 使 用 它 自 己 的 响应 式 用 户 界 面 库 Blaze; 

口 Spacebars 是 Meteor 默 认 的 模板 语言 ， 它 是 Handlebars 的 一 个 扩展 变化 ; 

口 Spacebars 使 用 表达 式 、 局 部 模板 、 块 和 辅助 函数 来 创建 小 的 、 模 块 化 的 模板 ; 

口 辅助 函数 可 被 限制 在 单个 模板 中 使 用 或 全 局 可 用 ; 

口 事件 映射 用 于 将 动作 关联 到 事件 和 元 素 上 ; 

口 每 个 模板 都 会 经 过 创建 、 稼 染 和 销毁 三 个 步骤 以 在 浏览 器 中 泻 染 出 来 ， 每 个 步 又 都 有 一 
个 相关 的 回调 函数 ， 可 用 来 添加 自 定义 行为 。 

















本 章 内 容 
口 Meteor 的 默认 数据 源 


口 响应 式 数据 和 计算 的 原则 

口 Session 对 象 

口 通过 collection 使 用 MongoDB 数 据 库 
口 CRUD 操 作 





如 第 1 章 所 述 ，Meteor 不 依赖 传统 的 、 以 服务 器 为 中 心 的 架构 。 它 也 在 每 个 客户 端 机 器 上 运 
行 代码 和 处 理 数 据 。 为 此 , 它 在 浏览 器 中 使 用 一 个 迷你 数据 库 来 模拟 真实 数据 库 的 接口 。 这 意味 
着 可 以 在 浏览 吉 上 以 同样 的 方式 访问 数据 ， 不 管 是 做 数据 库 查 询 还 是 访问 一 个 查询 的 结果 。 

如 果 所 有 可 用 数据 只 存在 于 某 个 客户 端 而 没有 更 新 到 中 央 服 务 器 , 那么 很 显然 , 该 客户 端 一 
有 旦 断 开 ， 这 些 数 据 就 会 丢失 。Meteor 通 过 同步 客户 端 和 服务 器 端的 状态 自动 进行 数据 持久 化 。 

有 一 些 信 息 是 只 与 某 个 客户 端 相 关 的 ， 比 如 状态 信息 、 哪 个 标签 被 点 击 或 从 下 拉 列 表 中 选择 
哪个 值 。 只 与 当前 用 户 会 话 有 关 的 信息 不 需要 存储 在 中 央 服 务 器 上 ， 也 不 需要 同步 。 图 4-1 说 明 
了 这 个 一 般 的 体系 结构 。 在 本 章 的 最 后 ， 你 将 能 够 使 用 collection 来 做 数据 库 的 数据 处 理 ， 使 
用 session 来 处 理 客户 的 会 话 信 息 o 

每 个 Web 应 用 的 实质 是 捕获 、 存 储 和 处 理 数 据 。 创 建 、 读 取 、 更 新 和 删除 数据 ， 通 常 被 称 为 
CRUD ， 是 构建 高 级 功能 的 基础 。CRUD 本 身 只 是 最 基本 的 功能 。 当 两 个 用 户 从 数据 库 读 取 同 一 
个 文档 ， 其 中 一 个 用 户 执行 某 个 更 新 时 ,我们 希望 这 个 更 新 立即 被 发 布 到 男 一 个 客户 端 。 至 少 我 
们 应 该 告诉 第 二 个 用 户 ， 这 个 文档 在 他 第 一 次 访问 之 后 已 经 改变 。 在 大 多 数 语言 和 框架 中 ,你 必 
须 手 动 设置 一 个 同步 过 程 ， 以 确保 所 有 客户 端 都 能 获得 更 新 过 的 数据 。 而 Meteor 通 过 响应 式 方法 
来 进行 适当 的 数据 流 管 理 。 

本 章 向 你 介绍 响应 性 的 关键 组 件 ， 以 及 如 何 利用 它 在 Meteor 中 执行 CRUD 操 作 。 为 了 说 明 这 
些 原则 ,我 们 将 把 一 个 现实 问题 变 成 一 个 应 用 : 想象 你 去 旅行 ,并 要 求 一 个 朋友 帮忙 照顾 你 的 植 
物 ， 你 给 他 留 一 个 便签 ， 让 他 每 周 给 红色 的 花 条 浇 一 次 水 。 我 们 将 构建 一 个 房屋 保姆 应 用 。 
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会 话 用 于 在 客户 端 记 住 当前 
的 应 用 状态 








1 服务 器 


持久 性 集合 用 于 在 服务 器 和 客户 端 之 间 易 失 性 
数据 存储 交换 数据 数据 的 存储 


图 4-1 数据 库 无 处 不 在 ， 这 意味 着 持久 数据 放 在 服务 器 上 ， 但 易 失 性 数据 放 在 客户 端 上 









































房屋 保姆 : 使 用 Meteor， 让 这 个 应 用 成 为 一 个 更 好 的 朋友 





当 Manuel 去 度假 时 ， 他 让 他 的 朋友 Stephan 每 周 为 红色 的 花 浇 一 次 水 。 他 把 指令 写 在 一 张 
便条 上 , 要求 执行 一 个 简单 的 动作 : 给 花 浇 水 。 这 个 动作 应 该 在 什么 时 候 实施 呢 ?” 当 一 个 星期 
虽然 这 似乎 是 一 个 简单 的 任务 , 但 我 们 应 该 创建 一 个 应 用 ,帮助 我 们 跟踪 什么 时 

疾 、 哪 株 植物 需要 浇 水 。 

es 任何 好 朋友 都 必须 把 两 个 数据 源 考虑 进去 : 花 和 日 历 。 后 者 没 
有 明确 提 到 ， 但 它 在 决定 是 否 应 该 浇 花 上 起 着 重要 的 作用 。 在 现实 世界 的 大 多 数 情 况 下 ， 这 
些 指令 不 0 对 初学 者 来 说 ,他 们 不 会 定义 一 周 从 哪 一 天 开始 ,甚至 要 浇 多 少 水 。 

自然 地 ， 一 个 真正 的 朋友 会 提供 丢失 的 上 下 文 。 Stephan 依 赖 日 历 灯 确定 是 否 要 浇 花 。 日 
历 只 是 一 个 普通 的 数据 源 ,但 为 每 周 浇 花 增加 了 一 个 依赖 性 ,这 样 它 变 成 了 一 个 响应 式 数 据 源 。 
Manuel 走 后 ，Stephan 每 天 看 看 自己 的 日 历 ， 如 果 是 星期 一 ， 他 就 会 去 给 红色 的 花 浇 水 。 为 了 
对 数据 的 变化 作出 反应 ，Stephan 创 建 了 一 种 心理 依赖 。 事 件 “ 星 期 一 ”和 动作 “ 浇 花 ”联系 
在 了 一 起 。 
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虽然 有 可 能 出 现 错误 ， 但 如 果 Stephan 可 以 做 一 些 合理 的 假设 会 更 方便 。 这 将 允许 Manuel 
使 用 一 个 便条 而 不 必 写 一 篇 1000 字 的 文章 来 说 明 他 离开 以 后 有 哪些 是 需要 做 的 。 
Meteor 会 连接 数据 源 和 操作 ， 并 提供 一 个 可 用 的 行为 使 开发 人 员 能 够 使 用 响应 式 数据 。 


读 完 本 章 后 , 你 将 会 熟悉 Meteor 中 最 重要 的 数据 源 。 你 将 知道 如 何 处 理 易 失 性 和 持久 性 数据 ， 
这 意味 着 你 可 以 把 数据 存储 到 数据 库 ， 从 数据 库 中 检索 数据 并 进行 完整 的 CRUD 操 作 。 我 们 还 将 
讨论 如 何 通过 所 谓 的 编辑 对 象 ， 利 用 Meteor 的 响应 式 方法 ， 实 现 双向 数据 绑 定 。 

我 们 要 使 用 Meteor 中 的 两 个 标准 包 来 实现 应 用 的 功能 ， 这 两 个 包 是 autopublish 和 
insecure。 这 两 个 软件 包 使 开发 更 容易 ， 正 如 其 名 所 示 ， 它 们 自动 在 所 有 客户 端 发 布 数 据 ， 并 
在 开发 过 程 中 通过 取消 严格 的 安全 检查 给 我 们 更 多 的 自由 。 这 样 ,我 们 可 以 完全 专注 于 添加 功能 ， 
不 必 处 理 安全 相关 的 设置 。 最 终 ， 在 第 7 音 ， 我 们 将 讨论 如 何 删 除 它 们 ， 为 部 署 应 用 做 准备 。 


4.1 Meteor 的 默认 数据 源 


在 Web 应 用 中 , 通常 会 处 理 两 种 类 型 的 数据 , 每 种 数据 类 型 都 与 特定 类 型 的 数据 源 相关 联 : 
口 易 失 性 数据 ， 或 短期 存储 ( 例如 内 存 ); 
口 持久 性 数据 ， 或 长 期 存储 〈 例如 文件 和 数据 库 )。 

易 失 或 短暂 的 数据 用 于 处 理 诸如 访问 当前 登录 用 户 这 样 的 事情 。 没 有 理由 将 此 数据 放 人 数据 
库 并 在 所 有 客户 端 共享 它 , 所 以 它 通 常 只 在 会 话 发 生 的 客户 端 实例 中 可 用 。 一 旦 浏览 器 窗口 关闭 ， 
所 有 的 易 失 数据 通常 就 都 消失 了 ， 除 非 它 被 以 cookie 或 浏览 器 本 地 存储 的 形式 存储 。 但 是 用 户 可 
能 配置 浏览 器 在 退出 时 删除 那些 数据 , 所 以 假设 存储 的 数据 在 用 户 下 一 次 访问 该 网 站 仍然 可 用 是 
不 安全 的 。 

持久 性 数据 是 应 用 实际 存储 的 任何 数据 。 这 可 以 包括 博客 文章 、 评 论 、 用 户 信 息 或 某 网 络 商 
店 的 产品 。 持 久 性 数据 源 对 Web 应 用 的 部 分 或 所 有 用 户 可 用 。Meteor 默 认 在 所 有 连接 的 客户 端 共 
享 所 有 的 持久 性 数据 源 。 在 开发 的 早期 阶段 ， 这 是 很 好 的 ,但 如 果 数 据 集 的 数量 增长 到 数 百 甚至 
数 千 , 这样 就 不 好 了 。 可 通过 自 定义 的 数据 订阅 来 清楚 地 定义 需要 传输 的 数据 ,这 样 可 以 避免 总 
是 传输 所 有 的 数据 ， 而 不 管 客 户 是 和 否 会 看 数据 。 还 可 以 通过 添加 一 个 安全 层 ， 避免 向 所 有 连接 的 
客户 端 发 送 那些 只 对 部 分 客户 可 用 的 敏感 数据 。 你 将 在 第 6 章 学 习 这 些 内容 。 

Meteor 被 设计 为 与 NoSQL 数 据 库 一 起 工作 , 因此 不 使 用 表 ( 这 一 点 不 同 于 MySQL 和 Oracle )， 
而 将 数据 存储 为 文档 。 集 合 类 似 于 数据 库 中 的 表 ,， 可 保存 一 个 或 多 个 文档 。 本 章 稍 后 将 讨论 更 多 
数据 库 的 内 容 。 

































































































































































































































































说 明 默认 情况 下 ，Meteor 将 所 有 数据 从 数据 库 发 布 到 所 有 客户 端 ， 除 非 autopublish 包 被 删 
除 。 我 们 会 在 第 6 章 讨 论 数据 发 布 时 这 样 做 。 





无 论 被 用 来 存储 易 失 性 数据 还 是 持久 性 数据 ,默认 情况 下 ，Meteor 中 所 有 内 置 的 数据 源 都 是 
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响应 式 的 。 表 4-1 概 括 了 最 常见 的 数据 源 以 及 它们 的 用 途 。 让 我 们 仔细 看 一 看 是 什么 使 它们 不 同 
于 非 啊 应 式 数据 源 。 








表 4-1 最 常见 的 数据 源 及 其 典型 应 用 
数据 源 典型 应 用 类 型 
使 用 Session 对 象 的 会 话 变量 多 步 动 作 的 选择 或 当前 步骤 易 失 
集合 (数据 库 查询 ) 数据 库 的 内 容 寺 久 











4.1.1 什么 使 数据 源 具 有 响应 性 


如 果 茶 件 事 的 发 生 是 以 前 发 生 的 另 一 件 事 的 结果 , 那么 它 通常 被 称 为 一 个 响应 。 这 个 概念 
同样 适用 于 Meteor。 要 应 用 响应 性 ,需要 数据 和 动作 ， 我 们 必须 创建 一 个 触发 机 制 ， 把 它们 连 
接 在 一 起 。 

没 必要 连续 不 断 地 评估 朋友 家 里 的 花 是 否 需 要 浇 水 。 通 过 使 用 日 历 ,我 们 已 经 有 一 个 数据 源 ， 
可 以 用 来 确定 是 否 需要 一 个 动作 。 我 们 有 一 个 动作 ,“ 检 查 花 是 否 需 要 浇 水 ”, 我 们 定义 这 个 动作 
在 每 周一 执行 。 因此 , 我 们 需要 使 用 日 历 作为 数据 源 , 用 以 告诉 我 们 今天 的 星期 数 是 否 已 经 改变 。 
如 果 它 改变 了 ， 就 必须 执行 一 次 检查 ， 然 后 可 以 再 等 待 下 一 天 ， 那 时 再 进行 检查 。 

创建 一 个 最 终 可 能 会 发 生 的 所 有 动作 和 关系 的 大 列表 不 是 一 个 有 效 的 方法 , 因为 维护 这 样 的 
列表 很 繁琐 。 此外， 如 果 我 们 忘记 检查 日 历 会 发 生 什么 ”在 大 多 数 框架 中 ,我们 必须 实现 频繁 的 
检查 ， 以 监测 日 历 可 能 发 生 的 变化 , 这 类 似 于 坐 在 一 张 桌子 上 , 不 断 地 看 着 时 钟 ， 以 免 错 过 可 能 
需要 浇 花 的 下 一 天 。 

Meteor 通 过 使 用 声明 的 方法 来 定义 数据 和 函数 之 间 的 关系 ,使 这 件 事情 变 得 更 容易 。 一 个 普 
通 的 日 历 ,通过 依赖 性 连接 到 检查 的 动作 ， 变 成 响应 式 数据 源 ， 它 的 行为 就 像 工作 日 的 闹钟 。 这 
样 ， 我们 就 可 以 利用 响应 性 ， 这 意味 着 我 们 将 基于 数据 源 发 起 的 警报 来 执行 检查 ( 参见 图 4-2 )。 
没 必要 显 式 地 检查 当前 的 一 天 是 否 已 经 改变 ， 因 为 当 它 发 生 的 时 候 ， 日历 会 通知 我 们 。 

当 数据 变化 时 …… 


今天 星期 几 ba 刘 2 
需 


Se 它 触 发 了 一 个 相关 的 动作 
图 4-2 ”数据 更 改 触 发 相关 动作 


通过 添加 一 个 依赖 关系 , 我 们 将 任何 常规 的 数据 源 变 成 响应 式 数据 源 。 响 应 式 数据 源 不 仅 可 
以 被 动 地 访问 ,而且 可 通过 使 它 失 效 来 主动 地 调用 函数 。Tracker 包 负责 创建 和 跟踪 依赖 关系 并 
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进行 计算 管理 ， 这 是 该 平台 响应 性 的 基础 。 





跟踪 器 : 幕后 的 依赖 性 跟踪 者 


事实 上 , 所 有 的 内 置 数 据 源 默 认 都 是 响应 式 的 ,这 意味 着 Meteor 会 自动 创建 和 跟踪 依赖 关 
系 。 它 通过 名 为 跟踪 器 (Tracker ) 的 包 来 做 这 件 事 。 这 个 包 用 来 为 数据 源 声 明 依赖 性 、 数 据 


无 效 计算 以 及 触发 重新 计算 。 

如 果 在 模板 中 只 用 到 了 Session 和 Collection 对 人 象 ， 你 可 能 不 需要 直接 使 用 跟踪 器 。， 
于 高 级 的 技术 ， 了 解 这 个 小 包 背 后 的 基本 原理 是 很 有 帮助 的 ， 这 个 包 的 代码 不 到 1KB。 目 
我 们 依靠 Meteor 来 为 我 们 跟踪 所 有 的 依赖 关系 ， 但 没有 明确 地 声明 。 我 们 将 在 第 7 章 再 次 
观察 变化 。 


前 ， 
学 到 


4.1.2 如何 将 响应 式 数据 连接 到 函数 




















对 


虽然 我 们 已 经 说 过 ， 响 应 性 是 Meteor 内 置 的 ， 你 可 以 免费 得 到 它 , 但 请 记 住 ， 只 有 编写 正确 
的 代码 ， 响 应 性 才 会 被 使 用 。 应 该 这 样 说 ，Meteor 提 供 了 响应 性 发 生 的 响应 性 上 下 文 。 这 些 上 下 




















文 可 以 通过 以 下 方式 来 创建 。 
口 模板 


D Blaze.render 和 Blaze.renderWithData 








D Tracker.autorun 





我 们 已 在 第 3 章 看 过 了 模板 和 Blaze 引 警 。 我 们 将 在 4.3 节 讨论 Session 对 象 时 使 用 Tracker. 








autoruno 





一 旦 创建 了 响应 性 上 下 文 ， 在 这 个 上 下 文中 的 函数 将 成 为 一 个 计算 (computation )。 计 算 会 


被 执行 ， 它 变 得 无 效 时 会 再 次 执行 。 响 应 式 数据 源 变 化 时 会 导致 函数 "的 无 效 。 


当 计 算 无 效 时 ,它们 会 重新 运行 ,这 使 它们 再 次 有 效 。 这 将 防止 函数 不 断 运行 ,制造 应 用 的 














混乱 和 不 确定 性 状态 。 无 效 是 数据 变化 的 直接 结果 ， 并 触发 一 个 动作 。 只 要 数据 没有 变化 , 计算 
就 不 会 失效 ， 因 此 不 会 再 执行 一 次 。 因 为 有 各 种 不 同 的 响应 性 上 下 文 ， 其 中 包含 各 种 依赖 关系 ， 











所 以 Meteor 会 腿 踪 列 表 中 的 所 有 依赖 关系 (参见 图 4-3 )。 














第 一 次 使 用 Meteor 时 ,你 可 能 没有 意识 到 你 在 使 用 响应 式 计算 。 当 数据 发 送 到 模板 时 ， 如 果 





有 任何 数据 变化 ，Meteor 将 重新 泻 染 。 例 如 ， 如 果 你 有 一 个 模板 ， 显 示 一 个 给 花 浇 水 的 提醒 , 忆 
么 如 果 使 用 了 一 个 响应 式 数据 源 ， 模 板 内 容 就 会 自动 更 新 ， 如 代码 清单 4-1 所 示 。 














GD 也 就 是 计算 。 一 一 译 者 注 
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响应 式 数据 源 模板 创建 一 个 响应 性 上 下 文 


会 话 和 计算 、 


Session = { 


















v 
Template.friendsHouse.helpers ({ 




























































today: "Tuesday" waterTheFlowers: nction () { 
使 计算 无 if CGession.get ("today" DD ——— "Monday") 1 
效 并 重新 returT "Watertng. the flowers"y 
进行 计算 
4 
在 计算 中 使 用 响 
应 式 数据 源 将 创 SR 
建 一 个 依赖 关系 依赖 关系 列表 











waterTheFlowers 一 > Session.get ("today") 














图 4-3 ”改变 响应 式 数据 源 导致 计算 无 效 ， 触 发 它们 的 重新 计算 





代码 清单 4-1 使 用 模板 辅助 函数 设置 一 个 响应 性 上 下 文 


创建 一 个 Template.friendsHouse.helpers({ | 响应 性 上 下 文 
响应 性 waterTheFlowers: function () { < 一 中 的 函数 称 为 
上 下 文 var day = Session.get ("today"); Ue | 计算 
if (day === "Monday") { 
return "Watering the flowers"; Session 是 一 个 响应 式 
} 数据 源 ， 当 它 的 内 容 改 
变 时 ， 它 会 使 计算 无 效 


a 


说 明 响应 性 上 下 文中 的 函数 被 称 为 计算 。 数 据 变化 时 ， 响 应 式 数据 源 使 计算 无 效 ， 导 致 计算 
再 次 执行 。 在 计算 中 使 用 的 所 有 响应 式 数据 源 自 动 与 该 计算 相关 联 。 











现在 ， 我 们 已 经 看 到 了 Meteor 自 动 做 的 


4.2 构建 房屋 保姆 应 用 


让 我 们 重 温 朋 友 给 花 浇 水 的 例子 吧 。 他 现在 不 仅 照 顾 别 人 的 植物 ,而 且 对 很 多 人 来 说 , 他 是 
个 专业 的 房屋 保姆 , 他 跟踪 数据 库 中 的 所 有 房屋 。 这 也 是 他 保存 所 有 给 植物 浇 水 指示 的 地 方 。 他 
将 使 用 一 个 简单 的 Web 应 用 来 查找 每 个 房屋 , 并 在 完成 访问 之 后 做 一 个 注解 。 这 个 应 用 将 使 用 以 
下 数据 源 : 
口 一 个 数据 库 ， 用 来 存储 所 有 的 朋友 、 指 示 和 注解 ; 
口 会 话 变量 ， 用 来 存储 当前 选 定 的 房屋 。 

图 4-4 显 示 了 用 户 界面 以 及 一 些 注 释 。 来 自 集合 的 所 有 数据 都 显示 在 次 色 的 盒子 里 ， 所 有 
session 对 象 中 的 临时 数据 都 显示 在 浅 色 的 盒子 里 。 如 果 我 们 从 更 高 的 视角 来 看 它 , 该 应 用 查找 


hl 





EE 情 ， 让 我 们 专注 于 要 做 的 事情 和 显示 数据 。 
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数据 库 中 的 所 有 记录 , 并 基于 临时 会 话 变量 的 值 来 获取 一 个 完整 的 文档 。 最 终 它 可 以 让 用 户 保存 


对 数 


据 库 的 更 改 。 


DD The House-Sitter 





€ 3 C [0 localhost:3000 


次 四 尼 = 





发 送 名 字 和 _ia 
到 下 拉 列 表 









在 session 中 存 
储 选 择 的 _ia | Plant color: blue 
Jnstructions: once a day | Done | 


Plant color: yellow 





















The House-Sitter App 


Taking care of Manuel's house 


Last visit Mon Oct 06 2014 13:37:50 GMT+0200 (CEST) 


JInstructions: 1 pot per week [Done ) 


| 
et 
=== Session var| 显示 文档 内 容 |Add a house 
的 文档 示 文 档 内 容 
Name |Name 
Plant 
Color[ Inswctions[ | 











图 4-4 ”房屋 保姆 应 用 的 用 户 界 
使 用 Meteor 的 CLI 工 具 创 建 一 个 新 项 目 : 


$ meteor create houseSitter 


下 和 数据 源 











让 我 们 在 不 同 的 文件 夹 中 组 织 我 们 的 代码 , 以便 更 容易 地 知道 哪些 代码 放 在 哪里 。 这样 就 不 
需要 在 任何 代码 上 添加 Meteor .isServer() 或 Meteor.isClient ()。 

有 些 代 码 只 应 该 在 客户 端 上 执行 。 这 些 放 在 clientclientjs 中 。 所 有 的 模板 将 被 放 在 
client/templates.html 中 。 只 在 服务 器 端 执行 的 代码 放 在 serverserverjs 中 ， 集 合 将 被 储存 在 
collections/houses.js 中 ， 因 为 它们 在 客户 端 和 服务 器 端 都 可 用 。 请 参考 图 4-5。 





发 送 到 浏览 器 一 、 

















房屋 保姆 应 





图 4-5 





一 在 服务 器 上 执行 
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4.2.1 设置 模板 


在 开始 使 用 响应 式 数据 之 前 ， 必 须 建立 一 个 骨架 结构 。 代 人 码 清单 4-2 显 示 了 我 们 网 站 的 主体 。 
它 包括 三 个 子 模板 : selectHouse, 它 允 许 用 户 选择 一 个 房屋 ; showHouse, 显示 数据 库 记 录 
的 所 有 相关 细节 ; 以 及 houseForm， 它 允许 用 户 添 加 和 编辑 数据 库 记 录 。 在 接 下 来 的 小 节 中 , 这 
些 将 被 定义 在 同一 文件 中 ， 所 有 的 模板 将 保持 尽 可 能 小 ， 没 有 必要 再 分 拆 它 们 。 


代码 清单 4-2 client/templates.html 的 基本 模板 结构 














<head> 
<title>The HouseSitter</title> 
</head> 
<body> 
<h1l>The House-Sitter App</h1l> 
{{> selectHouse }} 额外 模板 的 
{{> ShowHouse }} 包含 标签 
{{> houseForm }} 
</body> 
<template name="selectHouse"> 和 六 
</template> 
这 些 模 板 
<template name="showHouse"> 一 现在 仍然 
</template> 是 空 的 





<template name="houseForm"> 
</template> 


说 明 如 果 你 包含 的 模板 不 可 用 , Meteor 会 显示 一 个 错误 ,你 可 以 像 下 面 这 样 避免 碰 到 这 些 错误 : 
通过 创建 一 个 空 的 模板 ,或 从 主体 模板 中 删除 包含 标签 ， 直 到 真正 需要 子 模板 时 再 添加 。 











该 应 用 不 需要 任何 样式 的 定义 ， 所 以 client/style.css 文 件 是 空 的 。 如 果 你 想 添 加 样式 ,使 房屋 
保姆 应 用 更 加 漂亮 ， 这 里 就 是 你 添加 样式 的 地 方 。 


4.2.2 连接 到 数据 库 并 声明 集合 


虽然 你 将 在 4.4 节 学 习 集 合 ， 但 现在 就 需要 定义 一 个 ， 因 为 你 需要 一 些 可 用 的 数据 。 我 们 将 
在 本 章 的 后 面 讨论 集合 相关 的 细节 。 

MongoDB 是 一 个 面向 文档 的 或 者 NoSQL 数 据 库 。 它 的 内 容 不 是 存储 在 表 中 ， 而 是 存储 在 文 
档 中 。 多 个 文档 组 成 了 集合 。 因 此 ， 你 将 要 定义 一 个 新 的 Collection 对 象 ， 名 叫 Houses- 
collection， 它 将 存储 它 的 内 容 到 MongoDB 数 据 库 的 houses 集 合 中 。 在 collections 目 录 中 创建 
一 个 文件 ， 并 添加 代码 清单 4-3 所 示 的 代码 。 
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代码 清单 4-3 ”collections/houses.js 中 的 集合 声明 
HousesCollection = new Mongo.Collection('houses'); 
此 外 ,你 应 该 确保 数据 库 中 有 一 些 数据 , 所 以 需要 添加 一 些 服务 器 端 代码 , 在 应 用 启动 的 时 

候 检 查 Housescollection 中 是 否 有 可 用 的 数据 。 如 果 没 有 数据 , 我 们 将 在 数据 库 中 插入 一 个 新 

文档 ( 参见 代码 清单 4-4 )。 如 果 需 要 更 多 的 可 用 数据 ， 可 以 在 houses 数 组 中 添加 更 多 的 房 





























wal 


O 


说 明 Meteor.startup() 代 码 块 在 服务 器 和 客户 端 上 都 可 以 工作 。 服 务 器 上 的 代码 在 Node.js 
实例 启动 时 执行 一 次 ， 而 对 每 个 客户 端 而 言 ，DOM 就 绪 的 时 候 代 码 会 执行 一 次 。 





将 代码 放 在 Meteor .startup () 块 中 , 确保 它 仅 在 服务 器 启动 时 运行 。 理论 上 , 你 也 可 以 将 
此 代码 添加 到 客户 端 ， 但 Meteor .startup () 在 每 一 个 客户 端 成 功 连接 时 会 被 执行 。 因 为 有 if 
条 件 判断 ， 所 以 什么 都 不 会 发 生 ， 因 此 你 可 以 把 这 段 代 码 只 限制 在 服务 器 上 。 


代码 清单 4-4 ”在 server/server.js 中 添加 夹具 (fixture ) 





Meteor.startup(function () { A Be 
if (HousesCollection.find() .count() === 0) { Re 
var houses = [{ < 一 
name: 'Stephan', 
lb 检查 集合 中 是 否 
color: 'red', 有 任何 记录 
instructions: '3 pots/week'" 
Fz 
color: 'white', 定义 所 有 的 夹具 
instructions: 'keep humid' 为 数组 元 素 
} 
a 
while (houses. dengt i 将 houses 数 组 中 的 
HousesCollection.insert (houses.pop()); < 一 所 有 对 象 插入 到 数 
据 库 中 
console.log('Added fixtures'); 
} 控制 台 日 志 记录 也 
人 可 在 服务 器 上 工作 


说 明 console.1log() 命 令 在 浏览 器 控制 台中 工作 良好 ， 但 它 也 可 以 在 服务 器 上 下 文中 用 来 打 
印 消 息 。 可 以 运行 meteor 命 令 在 控制 台中 查看 输出 。 
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传统 上 ， 通 过 HTTP 来 访问 网 站 是 无 状态 的 。 用 户 请 求 一 个 文档 ， 然 后 再 请 求 另 一 个 。 因 为 
通常 需要 在 请 求 之 间 保 持 一 定 的 状态 ， 例 如 ， 保 持 用 户 的 登录 状态 ， 所 以 在 Web 应 用 中 存储 易 失 
性 数据 最 重要 的 方式 是 会 话 。Meteor 的 会 话 概念 与 PHP 等 语言 中 的 会 话 不 一 样 ， 后 者 在 服务 器 或 
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者 cookie 中 存在 一 个 专用 的 会 
存储 会 话 令 牌 以 保持 用 户 的 登录 状态 。 
专用 的 Session 对 象 只 在 客户 端 可 月 


话 对 象 . Meteor 不 使 用 HTTP cookie 而 使 月 





上 浏览 器 的 本 地 存储 , 例如 ， 











目 ， 并 且 存 在 于 内 存 中 ， 只 用 于 跟踪 当前 用 户 的 上 下 文 


和 动作 。 
4.3.1 _ Session 对 象 简介 
口 能 


session 对 象 拥有 键 一 值 对 ,只 能 在 客户 端 使 用 。 它 是 一 个 响应 式 字典 ,提供 了 get () 和 set () 
方法 。 在 通过 set () 设置 会 话 的 键 值 之 前 ， 它 会 保持 为 未 定义 状态 。 要 避免 未 定义 状态 ， 可 通过 
setDefault () 来 设置 一 个 默认 值 ， 它 的 工作 方式 和 set () 完全 相同 ， 但 只 有 当 该 值 未 定义 时 才 
有 效 。 检 查 会 话 值 是 一 种 常见 的 操作 ， 该 操作 可 以 通过 session 对 象 的 sauals () 函数 更 有 效 地 
进行 。 没 有 必要 使 用 var 语 法 声明 新 的 Session 变量 ， 因 为 该 变量 在 set () 或 setDefault () 方 
法 使 用 后 就 立刻 可 用 了 。 下 面 的 代码 清单 中 显示 了 相应 的 语法 。 












































代码 清单 4-5 ”使 用 会 话 对 象 
setDefault() 为 一 个 键 设置 一 个 值 , 只 
有 当 该 键 的 值 没有 被 定义 时 才 有 效 
返回 Session.setDefault ("key", "default value"); < 一 
默认 什 Session.get ("key"); | 将 一 个 新 值 赋 给 一 个 键 
Session.set ("key"，"new Value" ) ; 
Session.equals ("key", "expression"); 二 二 


“| 转化 为 Session.get("key") 
"expression"， 但 更 高 效 





提示 虽然 Session 变 量 通常 用 于 保存 字符 串 ， 但 它 也 可 以 保存 数组 或 对 象 。 





让 我 们 看 看 如 何在 房屋 保姆 应 用 中 使 用 session 对 象 。 可 以 把 session 看 作 应 用 的 短期 记 
用 于 跟踪 当前 选 定 的 房屋 。 


4.3.2 使 用 session 存储 选 定 的 下 拉 值 


对 于 selectHouse 模 板 ， 你 只 需要 一 个 下 拉 列 表 ， 这 样 用 户 就 可 以 从 数据 库 中 选择 一 个 房 
屋 。 想 法 是 从 数据 库 中 检索 所 有 的 文档 ,并 显示 所 有 可 用 的 名 称 。 一 旦 一 个 名 称 被 选中 , 它 将 定 
义 所 有 其 他 模板 的 上 下 文 ， 并 显示 一 个 房屋 。 你 将 使 用 代码 清单 4-6 显 示 的 代码 。 
{{#each}} 模 板 辅 助 函 数 用 于 遍历 所 有 从 数据 库 中 返回 的 房屋 。 数 据 上 下 文通 过 传递 
housesNameId" 参 数 来 显 式 地 设置 。{{_id}} 和 {{name}} 是 数据 库 中 house 对 象 的 属性 ， 所 以 
没有 必要 为 它们 定义 模板 辅助 函数 。 





忆 ， 















































@ 现在 housesNameId 包 含 的 不 仅仅 是 名 称 和 ID ， 但 不 要 担心 。 我 们 将 使 它 更 高 效 一 点 。 
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代码 清单 4-6 selectHouse 模 板 中 的 下 拉 列 表 代 码 


<template name="selectHouse"> 
<select id="selectHouse"> 

<option value="" {{isSelected}}></option> 
{{#each housesNameId}} 

<option value="{{_id}}" 





= = 











{{isSelected}}>{{name}}</option> 


使 用 一 个 空 选项 开 
始 选 择 列表 


{{/each}} < 
</select> each 遍历 housesNameld 
</template> 辅助 函数 返回 的 所 有 对 象 
在 client.js 文 件 中 定义 了 一 个 辅助 函数 , 提供 housesNameId 数 据 上 下 文 。 



































将 自动 调整 ， 选 择 框 将 反映 你 的 更 改 ， 而 这 不 需要 编写 专用 的 代码 。 





你 将 使 用 一 个 session 变 量 selectedHouseId 来 存储 下 拉 选 择 。 选 择 框 应 该 反映 实际 的 选 
择 ， 所 以 需要 添加 一 个 selected 属 性 到 当前 选 定 的 选项 。 要 这 样 做 ， 需 要 定义 另 一 个 名 为 
isSelected 的 辅助 函数 ， 它 返回 一 个 空 字 符 串 ,或 者 在 _id 值 等 于 session 变 量 时 返回 














selectedo 








最 后 一 步 是 基于 用 户 的 选择 设置 Session 变 量 的 值 。 因为 它 涉及 一 个 来 自用 户 的 动作 , 所 以 





需要 一 个 事件 映射 。 





每 当 iq 值 selectHouse 的 DOM 元 素 值 更 改 时 ， 事 件 处 理 程序 将 用 所 选择 的 选项 元 素 的 值 来 
需要 把 事件 作为 参数 传递 给 JavaScript 函 数 ， 该 函数 将 设置 


人 
[i 


设置 selectedHouseId。 注 意 ， 


Session 的 值 ， 以 便 将 来 对 它 进行 访问 ( 见 下 面 的 代码 清单 )。 
代码 清单 4-7 选择 房屋 的 JavaScript 代 码 


Template.selectHouse.helpers(t{ 











如 果 当 前 处 理 的 房屋 _id 等 
于 存储 在 会 话 变量 中 的 _id， 


从 集合 中 housesNameId: function () { 

扎 | 了 | 二 、 

返回 所 有 return HousesCollection.find({}, {}); 则 返回 selected 
的 文档 isSelected: function () { 


< 一 

return Session.equals('selectedHouseId', this._id) 
} 

3 

Template.selectHouse.events = { 
'change #selectHouse': function 

Session.set('selectedHouselId', 

} 

* . 





(evt) { 


人 


evt.currentTarget .value); 


'selected' : ' 


记得 将 事件 作 
为 参数 传递 给 
函数 ， 这 样 函 
数 可 以 将 选择 
的 值 赋 给 会 话 
证 旦 


< 一 


作为 测试 , 你 可 以 打开 浏览 器 内 部 的 JavaScript 控 制 台 并 从 下 拉 列 表 中 选择 一 个 值 , 看 一 切 是 
否 工 作 正常 。 你 也 可 以 直接 获取 和 设置 控制 台中 变量 的 值 。 如 果 将 值 更 改 为 有 效 的 _ia， 你 可 以 











看 到 ， 下 拉 列 表 将 立即 更 新 自己 ， 这 是 因为 isselected 辅 助 函数 的 作 上 月 








上 月， 如 图 4-6 所 示 。 





因为 我 们 还 没有 介 
绍 过 集合 的 细节 ， 所 以 现在 只 需要 返回 所 有 的 文档 和 字段 就 可 以 了 。 因 为 housesNameId 定 义 在 


一 个 Template 对 象 中 ， 所 以 它 是 响应 式 的 。 这 意味 着 如 果 在 数据 库 中 添加 或 删除 文档 ， 返 回 值 
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© meHousester x \ 
|€ SC D localhost3000 QQ 
,| 起 二 
改变 选 定 的 值 将 设 The House-Sitter App 
置 selecteqHouse 
的 值 i 
a |Q 罩 Elements Network Sources Timeline Profiles Resources 
径 任 [| 会 请 下 
ee © 富 <top frame> v Preserve log 
wi 值 、 9e- 位 全 se Session.get('selectedHouseId') 
剧 ¢ "fFeXptpRxKczjmTjm" 
> Session.get('selectedHouseId') 
"KQycFqipP2M9Qh5n4E" 
Session.set('selectedHouseId', 'fFeXptpRxKczjmTjm') 
设置 selectedHouse undefined 
的 值 将 自动 改变 下 拉 » | 
列表 的 显示 值 | Console Search | Emulation Rendering 


























图 4-6 ”通过 JavaScript 控 制 台 获取 和 设置 会 话 变 量 


4.3.3 使 用 Tracker .autorun 创建 响应 性 上 下 文 


使 用 JavaScript 代 码 时 , 你 经 常 需要 检查 一 个 变量 的 值 , 以 更 好 地 理解 为 什么 一 个 应 用 的 行为 
是 这 样 的。 你 可 以 使 用 console.1og() 方 法 , 它 是 调试 代码 最 重要 的 工具 之 一 ， 它 可 用 于 跟踪 
变量 的 内 容 。 因 为 你 正在 处 理 响 应 式 数 据 源 ， 所 以 你 也 可 以 利用 计算 来 监视 这 些 源 的 实际 值 。 在 
本 节 中 , 你 将 学 习 如 何 打印 响应 式 session 变 量 的 内 容 。 通 过 创建 一 个 用 于 执行 console.1og() 
的 响应 性 上 下 文 ， 可 在 Session 变 量 的 值 发 生 改变 时 打印 它 。 

在 4.1 节 中 ， 你 看 到 除了 模板 和 Blaze 之 外 ， 还 有 第 三 种 方法 来 建立 一 个 上 下 文 来 支持 响应 式 
计算 : Tracker.autorun()。 这 个 块 中 的 任何 函数 会 在 它 的 依赖 ( 即 它 使 用 的 响应 式 数 据 源 ) 
改变 时 自动 重新 运行 。Meteor 会 自动 检测 使 用 了 哪些 数据 源 ， 并 设置 必要 的 依赖 关系 。 

你 可 以 把 session.get ("selectedHous Igd") 放 在 一 个 autorun 晴 数 中 以 跟踪 它 的 值 ,将 
此 代码 放 在 clientjs 文 件 开始 的 地 方 ， 在 任何 模板 块 ( 见 代 码 清 单 4-8 ) 之 外 。 每 当 你 使 用 下 拉 列 
表 选 择 另 一 个 值 时 ， 控 制 台 立 即 打印 当前 选 定 的 ID。 如 果 没 有 选择 房屋 ， 它 将 打印 undefinead。 


代码 清单 4-8 使 用 Track-autorun() 把 Session 变量 打印 到 控制 台 

Tracket .autorun (function () { 

console.log("The selectedHouse ID is: "+ 
Session.get ("selectedHouseId") 

}) | | 

正如 你 所 看 到 的 ，session 对 象 使 用 简单 ， 但 它 非常 有 用 。 它 可 以 从 应 用 的 任何 部 分 访问 。 
并 且 它 会 保持 变量 值 不 变 ， 即 使 你 改变 源 文件 ，Meteor 重 新 加 载 应 用 ( 这 一 过 程 称 为 热 码 推送 ， 
hotcode pushes )。 然 而 ， 如 果 用 户 刷 新 了 页 面 ， 那 么 所 有 的 数据 就 都 丢失 了 。 

请 记 住 ,session 对 象 的 内 容 永远 不 会 离开 浏览 器 , 所 以 其 他 客户 端 或 服务 器 可 能 永远 无 法 
访问 它 的 内 容 。 这 是 使 用 集合 的 地 方 。 下 面 让 我 们 仔细 看 看 集合 。 
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4.4 MongoDB 集合 


Meteor 有 自己 的 MongoDB 实 例 , 一 个 开源 的 、 面 向 文档 的 NoSQL 数 据 库 。 每 次 你 使 用 meteor 
run 命 令 启 动 服务 器 时 ， 一 个 专用 的 数据 库 服务 也 启动 了 ， 它 监听 端口 3001 上 的 连接 。 默 认 情 况 
下 ，Meteor 使 用 此 实例 作为 它 的 数据 库 引擎 ， 并 将 所 有 内 容 存 储 在 一 个 名 为 meteor 的 数据 库 中 。 
没有 必要 定义 任何 数据 库 连 接 字 符 串 。 但 你 可 以 使 用 环境 变量 ( 如 MONGO_URL ) 让 Meteor 服 务 器 
指向 另 一 个 数据 库 实 例 。 第 12 章 将 详细 说 明 如 何 使 用 外 部 数据 库 而 不 是 默认 的 本 地 数据 库 。 






































什么 是 面向 文档 的 数据 库 ? 

MongoDB 是 一 个 面向 文档 的 NoSQL 数 据 库 。 和 关系 (SQL ) 数据 库 不 同 ， 它 的 每 个 记录 
是 独立 的 ， 不 会 根据 指定 的 关系 跨越 多 个 表 。 每 个 数据 库 记录 基本 上 就 是 一 个 JSON 对 象 。 

为 了 更 好 地 了 解 面 向 文档 的 数据 库 , 考虑 把 要 存储 的 所 有 数据 写 在 一 张 纸 (一 个 “文档 ”) 
上 。 如 果 想 跟踪 房屋 保姆 照顾 的 所 有 房屋 ， 你 会 为 每 个 房屋 创建 表格 ， 然 后 写 下 所 有 的 指示 。 
文档 存储 的 优点 是 所 有 相关 的 信息 都 放 在 一 个 单一 的 位 置 。 只 要 有 这 张 纸 , 你 就 有 了 需要 照顾 
房屋 的 所 有 信息 。 不 利 的 是 ， 如 果 多 个 房屋 都 有 相同 的 植物 , 或 者 科学 发 现 , 红色 的 花 条 每 周 
需要 浇 四 过 水 而 不 是 三 过 ， 那 么 你 将 不 得 不 改变 每 张 纸 上 的 指示 。 

每 个 文档 都 是 独立 的 ， 其 至 可 能 有 不 同 的 信息 (“字段 ”)， 这 反映 了 在 一 些 房屋 里 ， 你 需 
要 照顾 植物 ,而 在 其 他 的 房屋 里 ,你 可 能 需要 喂 兔子 。 你 不 必 写 下 任何 不 需要 采取 行动 的 字段 ， 
所 以 即使 两 个 文档 来 自 同一 个 集合 ， 它 们 也 不 必要 包含 相同 的 字段 : 










Name : Manuel 

Plants: 
坏人 lo Red 
Instructions: 3 pots/week 


Name: Stephan 
Plants: 
= ‘Color: Red 
Instructions: 3 pots/week 
- Color: White 
Instructions: water daily 
Animals: 
- Name: Danbo 
Instructions: 1 carrot/day 


DLOry Yel low 
Instructions: keep humid 








如 果 你 以 前 使 用 过 SQL 数据 库 ， 如 MySQL 或 Oracle， 下 面 是 常见 的 SQL 术语 和 等 价 的 面向 
文档 数据 库 的 术语 。 











SQL 术语 面向 文档 的 术语 
database (数据 库 ) database (数据 库 ) 
table ( 表 ) collection (集合 ) 
row ( 行 ) document (文档 ) 
column ( 列 ) field (字段 ) 





如 果 数 据 要 存储 一 个 较 长 的 时 间 段 , 或 如 果 它 应 该 在 客户 端 共享 . 那 就 应 该 使 用 集合 。 新 的 
数据 库 集合 使 用 Mongo 对 象 来 声明 。 下面 的 语句 ， 使 MongoDB 中 名 为 nycollection 的 集合 内 容 
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可 在 Meteor 应 用 中 作为 Mycollection 来 使 用 : 

MyCollection = new Mongo.Collection("mycollection"); 

因为 集合 应 该 从 服务 器 和 客户 端 都 能 访问 ,你 需要 确保 这 一 行 在 两 个 上 下 文中 都 执行 , 所 以 
它 不 应 该 被 包 在 任何 isclient () 或 isserver() 块 中 。 另 外 需 注 意 , 它 不 使 用 var 声 明 , 否则 将 
把 它 的 使 用 范围 限制 在 一 个 文件 中 。 














说 明 Meteor 中 的 集合 名 称 通 常 以 大 写字 母 开头 ,并 有 个 复数 名 称 。 如果 你 想 更 明确 ,可 以 在 它 
们 的 名 字 上 添加 Collection， 让 代码 更 具 可 读 性 。 集合 最 好 在 客户 端 和 服务 器 都 能 访问 
的 一 个 或 多 个 专用 文件 中 定义 。 











使 用 集合 的 基础 是 基于 MongoDB 的 工作 方式 ， 所 以 如 果 你 已 经 熟悉 Mongo 数 据 库 查询 的 语 
法 ， 可 以 在 Meteor 中 重用 这 些 知识 ， 甚 至 可 以 在 浏览 器 中 使 用 。 


4.4.1 在 MongoDB 中 查询 文档 


在 MongoDB 中 ,文档 查询 可 使 用 fina () 或 findone()。 前 者 返回 所 有 匹配 的 文档 ,后 者 只 
返回 匹配 指定 搜索 条 件 的 第 一 个 文档 。 这 些 条 件 作为 一 个 对 象 传递 给 查询 ,对 象 的 名 字 为 查询 文 
件 (query document ) 或 选择 器 ( selector )。 如 果 没 有 定义 选择 器 ， 将 匹配 所 有 的 文档 。 

要 找到 名 字 是 “Stephan” 的 文档 ,我们 需要 确保 选择 器 包含 搜索 字段 ( name ) 和 期 望 的 值 
("stephan" )。 字 上 段 名 称 或 键 不 需要 引号 : 


MyCollection.findone ({name: "Stephan"}); 


findone () 操作 在 名 为 Mycollection 的 集合 上 执行 。 它 匹配 并 返回 name 字 段 的 值 等 于 
"Stephan" 的 第 一 个 文档 。 

要 寻找 所 有 包含 给 白色 植物 浇 水 指令 的 文档 ， 则 需要 一 个 更 高 级 的 查询 。 这 一 次 将 执行 
find() 函数 ， 所 以 Mycollection 中 所 有 的 匹配 文档 都 将 返回 。 查 询 文 档 指定 plants 键 中 必须 
包含 男 一 个 键 color。 术 语 Sexists: 1 意 为 所 有 匹配 文档 中 必须 有 这 个 字段 。 


Collection.find({"plants.color" : {Sexists: 1 } }); 


要 检查 字段 是 否 包含 特定 的 值 ， 可 以 使 用 sin 而 不 是 $exists。 如 果 想 找到 所 有 的 文档 ， 其 
中 包含 color 属 性 为 "white" 的 植物 ， 使 用 以 下 查询 : 

Collection.find({"plants.color" : {S$in: ["White"] } }); 

除了 搜索 条 件 ， 可 以 传递 给 查询 操作 第 二 个 对 象 。 它 被 称 为 投影 ( projection )。 你 可 以 使 用 
它 来 限制 应 该 返回 的 字段 ,更 改 排序 顺序 , 或 在 返回 搜索 结果 之 前 对 它们 应 用 任何 一 种 操作 。 投 
影 可 以 和 查询 文档 一 起 使 用 ,也 可 以 独立 使 用 。 如 果 不 需 要 搜索 条 件 ， 则 将 一 个 空 选择 器 传递 给 
find() 捕 数 。 

下 面 的 查询 只 返回 每 个 文档 中 的 name 字 上 段 和 值 。 术 语 name :1 可 以 理解 为 “设置 字段 name 
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可 见 ”， 因 为 1 代表 真 。 使 用 0， 可 定义 从 检索 中 排除 的 字段 : 
Collection.find({}, {name:1}) 


正如 你 从 这 些 例 子 中 看 到 的 ， 使 用 集合 的 查询 和 使 用 SQL 完 全 不 同 。 你 不 是 在 处 理 表 和 行 ， 
而 是 在 处 理 行为 和 对 象 相似 的 文档 ， 记 住 这 一 点 是 有 帮助 的 。 









































说 明 使 用 MongoDB 的 更 多 细节 ， 请 参考 官方 文档 : http://docs.mongodb.org/。 


4.4.2 ”Meteor 的 集合 


在 最 基本 的 层面 上 ,可 以 将 数据 存储 在 集合 中 作为 一 个 文档 , 需要 显示 数据 时 ,可 以 查找 和 
获取 一 个 或 多 个 文档 。 让 我 们 开始 填充 数据 到 houses 集 合 。 
处 理 集合 时 最 重要 的 函数 如 表 4-2 所 示 。 


表 4-2 ”使 用 集合 时 最 重要 的 函数 概述 
























































功 能 使 用 案例 返 回 值 
Collection.find() 查找 与 选择 器 匹配 的 所 有 文档 游标 
collection.findone() ”查找 匹配 选择 器 和 投影 标准 的 第 一 个 文档 对 象 
Collection.insert () 在 集合 中 插入 文档 字符 串 (document_iqd) 
collection.update() 修改 集合 中 的 一 个 或 多 个 文档 受 影响 的 文档 数 
Collection.upsert () 在 集合 中 修改 一 个 或 多 个 文档 ， 如 果 没 有 匹配 的 话 ， 插 入 一 对象 

个 新 的 文档 
Collection.remove() 从 集合 中 移 除 文档 对 象 


游标 介绍 : finda() 和 findone() 之 间 的 差异 

单一 的 文档 可 以 通过 使 用 findone () 来 从 集合 中 获取 。 这 个 函数 返回 一 个 JavaScript 对 象 ， 
可 以 像 任何 其 他 对 象 一 样 处 理 它 。fina() 函数 用 来 检索 多 个 文档 ， 但 它 不 返回 任何 文档 ， 而 是 
返回 一 个 游标 。 游 标 是 一 个 响应 式 数据 源 ， 而 不 是 集合 。 

你 可 以 将 游标 看 作 最 终 对 数据 库 执行 的 查询 ,游标 允许 你 批量 发 送 数据 ,处理 大 型 数据 集 时 ， 
你 会 发 现 总 是 从 查询 中 返回 所 有 的 文档 效率 不 高 ， 通 过 遍历 结果 批量 发 送 数据 会 更 高 效 。 

现在 , 我 们 不 直接 对 游标 进行 处 理 , 因为 Meteor 知 道 如 何 处 理 collection.finqa() 的 结果 。 
我 们 在 第 9 章 讨论 更 高 级 的 用 例 时 ， 将 重新 审视 这 个 话题 。 


4.4.3 ”初始 化 集合 
对 于 每 个 需要 照顾 的 房屋 , 在 数据 库 中 将 有 一 个 文档 ,该 文档 将 包括 名 字 和 需要 照顾 的 植物 。 
为 了 使 整个 应 用 的 代码 具有 更 好 的 可 追溯 性 ， 你 可 以 使 用 一 个 宛 长 的 名 字 帮 你 跟踪 集合 对 象 。 


4.2.2 节 中 已 经 添加 了 必要 的 代码 , 所 以 没有 必要 再 添加 这 行 代 码 。Housescollection 将 提供 所 
有 数据 库 记录 的 接口 : 
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HousesCollection = new Mongo.Collection("houses"); 


没有 必要 在 集合 中 创建 任何 数据 结构 。 当 第 一 个 记录 被 添加 到 集合 时 ， 如 果 该 集合 不 存在 ， 
Meteor 会 自动 在 数据 库 中 创建 一 个 集合 。 

4.2.2 节 中 ， 在 设置 应 用 时 定义 的 服务 器 代码 将 创建 一 个 数据 库 集合 并 填充 数据 。 正 如 在 第 2 
章 冰 箱 的 例子 中 所 看 到 的 ， 你 也 可 以 使 用 浏览 器 控制 台 来 添加 新 的 数据 。 我 们 将 在 第 6 章 讨 论 发 
布 和 方法 时 添加 安全 机 制 , 用 以 禁止 从 浏览 絮 添 加 数据 。 现 在 让 我 们 专注 于 添加 功能 ， 而 不 是 准 
备 生 产 。 
使 用 夹具 的 一 个 重要 副作用 是 ， 你 知道 数据 结构 看 起 来 是 什么 样子 。 因 为 你 面 对 的 是 一 个 
NoSQL 数 据 库 ， 所 以 每 个 文档 可 以 有 完全 不 同 的 结构 ， 因 此 手边 有 可 以 参考 的 记录 是 比较 好 的 。 
虽然 可 能 有 其 他 字段 ( 如 动物 或 该 子 ), 但 每 个 房屋 文档 的 预期 字段 显示 了 在 表 4-3 中 。 在 这 个 例 
子 中 ， 你 只 照看 植物 。 
























































表 4-3 ”房屋 集合 的 期 望 字段 


























字段 名 称 包 含 笔 记 
-id 每 个 房屋 的 唯一 标识 ， 字 符 串 通过 MongoDB 自 动 分 配 
Ame 每 个 房屋 的 显示 名 称 ， 字 符 串 
lastvisit 最 后 操作 的 时 间 惟 ， 日 期 应 用 逻辑 生成 
Dhants 需要 照顾 的 家 庭 植物 ， 对 象 数组 
plants.color 每 个 房屋 独 有 的 植物 颜色 ， 字 符 串 “没有 数据 库 约 束 ， 唯 一 性 必须 由 应 用 的 逻辑 确保 





























plants.instructions 植物 的 痰 水 说 明 ， 字 符 串 


4.4.4 查询 集合 


在 开发 环境 中 , 依赖 于 所 有 的 数据 都 具有 响应 性 是 很 方便 的 , 但 对 于 较 大 的 数据 集 , 每 个 孙 
数 都 对 任何 数据 变化 进行 响应 将 有 明显 的 性 能 影响 。 对 于 房屋 的 下 拉 列 表 , 是 否 有 人 在 某 个 文档 
中 添加 或 删除 植物 并 不 重要 ， 所 以 响应 性 只 限制 在 name 和 _ia 字 段 。 


1. 仅仅 返回 特定 字段 

在 上 一 节 中 , 你 定义 housesNameIgd 辅 助 函 数 来 返回 HousesCollection 中 的 所 有 东西 , 现 
在 你 将 返回 值 限制 为 字段 hame 和 _iqd， 如 代码 清单 4-9 所 示 。 选 择 器 对 象 仍然 是 空 的 ， 但 你 将 传 
递 第 二 个 具有 fields 属 性 的 对 象 到 游标 。 在 对 象 里 面 ， 你 可 以 将 各 个 字段 设置 为 1， 这 意味 着 它 
们 将 被 返回 。 或 者 ， 你 可 以 设置 字段 为 0 以 不 返回 它们 。 但 不 能 混合 包含 (1 ) 和 排除 (0 )。 所 有 
的 键 必 须 同 时 设置 为 0 或 1。 


代码 清单 4-9 限制 返回 到 下 拉 列 表 的 字段 
Template.selectHouse.helpers ({ 
housesNameId: function () { 
return HousesCollection.find({}, {fields: {name: 1, _id: 1} }); 



































sy 
// isSelected 定 义 
Ey 
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2. 返回 一 个 完整 的 文档 

一 旦 用 户 从 下 拉 列 表 中 作出 一 个 选择 ,你 就 希望 显示 完整 的 房屋 文档 。 在 这 种 情况 下 ， 显然 
需要 返回 文档 中 的 所 有 字段 , 男 外 创建 一 个 辅助 函数 , 它 将 基于 session 变 量 selectedHouseId 
的 值 来 返回 一 个 文档 的 所 有 字段 。 这 个 辅助 函数 将 在 showHouse 模 板 里 面 使 用 ， 所 以 需要 在 
client.js 文 件 中 添加 这 段 代码 块 ， 如 代码 清单 4-10 所 示 。 


代码 清单 4-10 ”基于 ID 将 数据 库 文档 返回 到 模板 
Template.showHouse.helpers({ 
house: function () { 
return HousesCollection.findOonel({ 
_id: Session.get ("selectedHouseId") 
2 
} 
| 


这 一 次 ， 你 使 用 的 是 查询 文档 ， 但 没有 向 fijngdone () 函数 传递 任何 参数 "。 结 果 ， 你 会 得 到 
存储 在 MongoDB 中 的 完整 文档 对 象 。 这 个 对 象 可 以 像 JavaScript 中 的 其 他 对 象 一 样 进行 访问 。 


4.4.5 在 模板 中 显示 集合 数据 


Meteor 模 板 使 得 访问 辅助 函数 返回 的 对 象 内 的 数据 很 容易 。 所 有 你 需要 的 是 一 个 双重 大 括号 
标签 ， 然 后 引用 对 象 的 名 称 和 想 要 显示 的 特定 字段 。 要 显示 house 返 回 的 文档 内 存储 的 名 称 ， 可 
以 使 用 { {house .name}}。 要 去 除 每 个 house 对 象 属性 的 前 级 ， 可 使 用 #with 块 来 设置 数据 上 下 
文 ， 这 是 很 有 用 的 ， 它 使 模板 更 具 可 读 性 。 

为 了 提升 用 户 体验 ,你 将 添加 一 个 条 件 来 检查 是 否 已 作出 有 效 选 择 。 如 果 没 有 作出 选择 ,该 
模板 应 要 求 用 户 作出 选择 。 
每 个 植物 都 应 该 显示 颜色 信息 、 演 水 指示 以 及 用 来 标记 该 植物 已 浇 过 水 的 一 个 按钮 。 

为 了 显示 文档 的 内 容 , 可 以 把 所 有 的 东西 放 在 showHouse 模 板 里 或 使 用 专用 的 子 模板 。 使 用 
子 模板 将 带 来 更 大 的 灵活 性 和 可 管理 性 ， 未 来 你 可 能 想 要 支持 宠物 、 孩 子 或 清扫 。 

当 包 含 一 个 子 模板 时 ， 它 继承 了 父 模板 的 数据 上 下 文 。 这 样 ， 你 不 需要 定义 新 的 辅助 函数 ， 
只 需要 写 更 少 的 代码 。 在 代码 清单 4-11 所 示 的 例子 中 ， 你 可 以 看 到 数据 上 下 文 不 是 直接 从 父 模板 
继承 的 ， 而 是 通过 {{#each plants}} 来 指定 的 。 子 模板 中 ， 循 环 的 当前 plant 对 象 是 定义 的 上 
下 文 。 你 仍然 可 以 使 用 父 模 板 中 相同 的 表达 式 ， 但 记 住 ,现在 你 在 house 内 一 个 更 深 的 层次 。 要 
访问 父 模板 属性 ， 如 房屋 标识 ， 必 须 使 用 . . /符号 。 


代码 清单 4-11 显示 房屋 及 所 有 植物 的 模板 代码 


<template name="showHouse"> 


















































































































































{{#with house}} | 一 一 一 一 显 式 设置 
<h2>Taking care of {{name}}'s house</h2> 模板 的 数 


每 个 数据 库 字段 是 房屋 对 象 的 | 。” 据 上 下 文 
一 个 属性 ， 可 以 使 用 点 号 访问 


Qa 实际 上 我 们 是 传递 了 一 个 参数 给 它 的 ， 只 是 没有 传递 第 二 个 参数 。 一 一 译 者 注 
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{{#each plants }} 了 < 一 一 一 一 each 为 子 模板 
{{> plantDetails }} < 进一步 缩小 数 
{{/each}} 据 上 下 文 
{{else}} 
You need to select a house. 包含 一 个 子 模板 ， 
{{/with}} plantsDetails 
</template> 
<template name="plantDetails"> 5 
<p> 
<strong>Plant color:</strong> {{color}} 
</p> 
D> 


<strong>Instructions:</strong> {{instructions}} 
<button class="water" data-id="{{../_id}}-{{color}}" {{isWatered}} 
Done 
</button> 
A eb 
</template> 


将 这 两 个 模板 添加 到 应 用 中 ,现在 你 可 以 选择 一 个 房屋 并 查看 它 的 内 容 , 无 论 植物 数量 是 多 少 。 


ReactiveVvar: 具有 局 部 作用 域 的 Session 的 力量 

Session 需 要 全 局 唯一 的 名 称 , 或 从 技术 上 来 说 , 它 在 全 局 范围 内 有 效 。 有 时 你 希望 一 个 
变量 可 以 在 应 用 中 随处 可 用 , 但 在 许多 情况 下 ,变量 的 使 用 应 该 限制 在 应 用 的 一 部 分 , 其 至 是 
单个 模板 中 。 

作为 一 个 经 验 法 则 ,你 应 该 避免 把 太 多 变量 放 到 全 局 域 ,特别 是 那些 只 在 本 地 使 用 的 变量 ， 
如 浇 过 水 的 状态 。 为 了 让 事情 保持 简单 ,我 们 专注 于 Session 对 象 ,， 让 我 们 在 房屋 保姆 应 用 中 
使 用 这 个 限制 。 

对 于 更 大 的 项 目 ， 如 果 想 提高 代码 的 质量 ， 可 以 使 用 局 部 作用 域 的 响应 式 变量 ， 它 确切 的 
名 字 叫 ReactiveVatr。 这 个 ReactiveVatr 包 是 Meteor 框 架 核心 的 一 部 分 ， 但 必须 通过 命令 行 
手动 添加 它 : 

$ meteor adqd reactive-var 

ReactiveVar 和 Session 都 使 用 get () 和 set () 函数 ， 但 ReactiveVat 不 污染 全 局 命名 
空间 ， 并 可 以 限制 在 局 部 范围 内 。 你 可 以 在 相同 的 模板 中 重用 它 ， 且 重用 时 可 使 用 不 同 的 值 。 

就 像 Session 一 样 ，ReactiveVar 存 储 键 一 值 对 。 它 可 以 将 整个 对 象 存储 为 值 。 更 新 
ReactiveVar 容 器 的 内 部 对 象 需要 使 用 set () 。 因 为 它 的 使 用 范围 是 一 个 模板 的 上 下 文 ， 所 
以 你 必须 在 模板 的 createqd 回 调 函数 中 声明 一 个 新 的 ReactiveVar。 它 没有 setDefault () 
函数 ， 但 你 可 以 在 声明 一 个 新 的 ReactiveVatr 实 例 时 传 给 它 一 个 默认 值 : 


Template.plantDetails.onCreated(function () { 
this.watered = new ReactiveVar(); 
this.watered.set (false); 


> 
这 里 ， 关 键 字 this 指 当前 可 用 的 数据 上 下 文 ( 这 恰好 是 单个 plants 对 象 的 内 容 )。 在 一 
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个 事件 映射 中 ， 当 单 击 按钮 时 ， 可 以 将 它 的 值 设置 为 Lrue。 你 必须 使 用 这 个 函数 的 第 二 个 参 
数 tpl， 它 保存 了 对 模板 的 引用 。 因 为 watered 是 模板 的 一 个 属性 ， 所 以 你 可 以 这 样 设置 : 


Template.plantDetails.events(t{ 
euler nn ne on Ce el 
tpl.watered.set (true); 
有 
J 
最 后 ， 在 辅助 函数 中 ， 当 前 值 是 可 以 访问 的 。 在 这 里 ， 你 必须 使 用 相应 的 Template. 
instance() 语 法 来 访问 当前 的 模板 实例 : 
Template.plantDetails.helpers({ 
Wael Gnd eon 
ET 


} 
J 


事件 映射 和 数据 关联 

除了 简单 地 从 文档 中 呈现 数据 外 , 你 还 希望 能 够 标记 一 个 浇 过 水 的 植物 。 单 击 一 个 按钮 会 触 
发 一 个 事件 ,设置 一 个 植物 的 状态 为 vatered ( 浇 过 水 的 ),。 但是， 如 果 在 房屋 之 间 切 换 时 ， 你 
希望 保持 一 个 植物 的 状态 。 要 做 到 这 一 点 , 可 再 次 使 用 session 变 量 。 这 一 次 不 能 在 应 用 的 代码 
中 设置 名 称 ， 因 为 你 不 知道 每 个 房屋 有 多 少 种 植物 。 因 此 ， 你 将 动态 地 为 每 个 植物 创建 一 个 ID ， 
其 中 包括 文档 的 _igd 和 color 属 性 。 可 以 这 样 做 的 原因 是 ， 你 把 color 定 义 为 一 个 房屋 里 的 每 个 
植物 的 唯一 标识 。 

使 用 HTML 属 性 aata-iq 将 唯一 的 元 素 ID 传递 给 应 用 代码 是 常见 的 做 法 。 事 件 映射 监视 任何 
类 为 watezr 的 按钮 ， 对 于 当前 单 击 的 按钮 存储 其 aata-ia 的 值 ， 而 这 个 值 中 包含 了 文档 的 ID 和 
color 属 性 值 。 代 码 清单 4-12 中 显示 的 事件 映射 可 以 使 用 aata-ida， 而 不 必 自 己 创建 复合 ID。 

一 旦 按钮 被 点 击 ， 一 个 具有 新 的 复合 ID 值 的 session 变量 将 被 设置 为 true。 没 有 必要 为 该 
session 变量 设置 一 个 默认 值 。 记 住 ， 技 术 上 它 是 session 对 象 内 存储 的 一 个 键 一 值 对 ， 所 以 可 
以 在 任何 时 候 添 加 新 的 键 。 


代码 清单 4-12 ”用 于 给 植物 浇 水 的 事件 映射 


Template.plantDetails.events({ 






















































































'click button.water': function (evt) { 对 每 个 植物 ， 
var plantId = $(evt.currentTarget) .attr('data-id'); < 一 data-id 包 含 一 
Session.set (plantId, true); 个 唯一 的 ID 


} 
国友 1 


当 一 个 植物 被 浇 过 水 后 , 你 想 禁 用 按钮 , 以 此 作为 标示 , 说 明 这 个 植物 不 再 需要 更 多 的 关注 。 
你 将 使 用 一 个 辅助 函数 (代码 清单 4-13 ) 来 做 这 件 事 请 ， 它 类 似 于 用 于 在 下 拉 列 表 中 确定 当前 选 
定 房屋 的 那个 辅助 函数 。 因 为 使 用 的 是 全 局 可 用 的 Session 变 量 , 所 以 你 可 以 给 Manuel 家 的 红色 
植物 浇 水 ,然后 切换 到 Stephan 的 家 ， 随 后 回 到 Manuel 家 时 ， 你 发 现 这 个 按钮 仍然 是 被 禁用 的 。 
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代码 清单 4-13 ”用 于 禁用 Done 按 钮 的 模板 辅助 函数 


Template.plantDetails.helpers({ 
isWatered: function () { 
var plantId = Session.get ("selectedHouseId") + '-' + this.color; 
return Session.get (plant1Id) ? 'disabled' : ' 
} 


除非 用 户 强 制 刷 新 页 面 ， 否 则 存储 在 Session 对 象 中 的 内 容 都 将 在 应 用 的 全 局 范围 内 可 用 。 











4.4.6 ”在 集合 中 更 新 数据 


可 以 通过 collection.update() 图 数 来 更 新 集合 内 的 数据 。 虽 然 在 服务 需 上 调用 时 ， 它 可 





以 同时 修改 一 个 或 多 个 文档 ,但 在 客户 端 上 运行 时 ，upqdate () 函数 只 限于 基于 _id 操 纵 单个 文 
档 。 这 是 为 了 避免 意外 的 批量 操作 阻塞 服务 器 上 的 所 有 用 户 。 如 果 需 要 一 次 更 新 多 个 文档 , 可 以 
使 用 服务 器 端的 方法 ( 参见 第 6 章 )。 


分 ， 


使 用 upaate () 时 ， 需 要 指定 哪些 文档 需要 更 新 、 如 何 更 新 它们 ， 给 出 选项 和 回调 函数 错 








为 第 一 个 返回 值 ， 受 影响 的 文档 数量 为 第 二 个 返回 值 ): 


Collection.update(selector, modifier, options, callback); 

只 有 两 个 选项 是 可 用 的 ， 它 们 都 是 布尔 值 。 

DQ multi 

默认 值 是 false。 如 果 把 它 设置 为 crue， 所 有 的 匹配 文档 都 会 被 更 新 ; 否则， 只 有 第 一 
个 匹配 文档 被 更 新 。 

D upsert 

默认 值 是 false。 如 果 把 它 设置 为 crue， 则 在 没有 找到 匹配 的 文档 时 ， 它 会 插入 一 个 新 
的 文档 。 

要 从 客户 端 调 用 update () ， 你 必须 在 第 一 个 参数 中 提供 一 个 _ia。 这 是 第 一 个 参数 的 一 部 

第 一 个 参数 也 被 称 为 选择 器 。 它 可 以 是 一 个 包含 _ig 属 性 的 对 象 或 一 个 包含 有 效 文档 ID 的 字 









































符 串 。 更 新 时 使 用 标准 的 Mongo 语 法 来 定义 如 何 修改 当前 数据 。 表 4-4 给 出 了 一 些 最 常见 操作 的 
概述 。 下 面 的 命令 更 新 一 个 _id 为 12345 的 文档 ， 把 它 的 name 字 上段 设 为 Updateqd Name: 

















Collection.update({_id: "12345"}, {S$set: {name: "Updated Name"}}); 


表 4-4 ”常用 的 集合 更 新 操作 概述 








更 新 操作 符 描述 

Se 将 字段 的 值 增加 指定 值 

$set 设置 文档 中 字段 的 值 

$unset 从 文档 中 删除 字段 

Srename 重 命名 文档 字段 

$addtoset 如 果 数 组 中 不 存 某 些 元 素 ， 则 将 它们 添加 到 数组 中 











84 第 4 章 数 据 











( 续 ) 
更 新 操作 符 描 述 
Spush 向 数组 中 添加 一 个 元 素 
Spull 别 除 与 指定 查询 匹配 的 所 有 数组 元 素 





说 明 对 客户 端 实 现 Minimongo 而 言 ， 不 是 所 有 MongoDB 中 的 功能 都 可 用 。 你 可 以 查阅 
minimongo 包 内 部 的 注释 文件 来 了 解 当前 的 限制 。 


通过 事件 触发 更 新 

到 目前 为 止 , 我 们 只 是 展示 了 如 何 使 用 session 变量 来 存储 数据 , 这 意味 着 一 旦 浏览 货 窗 口 
关闭 或 用 户 强制 重新 加 载 页 面 ,所 有 的 数据 就 都 消失 了 。 为 了 跟踪 每 个 房屋 最 后 一 次 访问 的 时 间 ， 
可 以 扩展 事件 处 理 程序 ， 将 当前 日 期 存储 到 数据 库 中 。 这 将 在 每 个 house 文 档 中 使 用 
lastvisited 字 段 。 同 样 ， 在 添加 数据 之 前 ， 你 不 必定 义 数据 库 的 结构 ， 只 需 在 现 有 文档 中 添 
加 一 个 新 字段 。 

在 client,js 文 件 中 ， 你 需要 扩展 plant-Details 模 板 现 有 的 事件 处 理 程序 ， 只 要 添加 两 行 代 
码 (代码 清单 4-14 )。 新 的 Ilastvisit 变 量 将 被 赋值 为 当前 的 时 间 戳 。 它 将 用 于 upaate () 函数 以 
更 新 当前 文档 "。 请 注意 ， 因 为 你 现在 正在 处 理 两 个 D : 一 个 是 植物 ID ， 另 一 个 是 房屋 ID 。 让 我 
们 先 不 管 plantId， 对 于 文档 ID 使 用 selecteqHouseId 会 话 变量 来 指定 upaate 语 句 中 的 ID。 


代码 清单 4-14 ”扩展 事件 映射 ,添加 最 后 的 访问 日 期 
Template.plantDetails.events(t{ 
'click putton.water': function (evt) { 
var plantId = $(evt.currentTarget) .attr('data-id'); 
Session.set (plantId, true); 






























































var lastvisit = new Date(); < 一 
lastvisit 包 含 
HousesCollection.updatel(t{ a i 
_id: Session.get ("selectedHouseId") 当前 的 时 间 戳 
Fz 
SSset: { 
、 Jastvisit: lastvisit 六 = 一 将 当前 所 选 文档 的 
lastvisit 字 段 设置 为 
) 当前 时 间 戳 


}); 


每 次 一 个 房屋 里 的 植物 被 浇 水 后 ( 也 就 是 说 , Done 按 钮 被 单 击 ), 1astvisit 字 有 段 获得 更 新 。 
要 验证 这 个 更 新 确实 发 生 了 ， 你 可 扩展 showHouse 模 板 来 显示 lastvisit 的 值 ， 如 下 列 代 人 码 清 
单 所 示 。 


代码 清单 4-15 ”添加 1astvisit 时 间 鹤 到 showHouse 模 板 


<template name="showHouse"> 























@ 浏览 器 中 实现 的 Minimongo 不 支持 MongoDB 的 全 部 功能 集 。 因 此 ，s$currentDate 在 客户 端 上 是 不 可 用 的 。 
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{{#with house}} 


7 添加 这 一 行 来 显示 
<p>Last visit: {{lastvisit}}</p> 作为 lastvisit 保 存 
es | 的 时 间 蕉 
{{/with}} 
</template> 








单 击 每 个 植物 的 按钮 会 自动 禁用 该 按钮 ， 同 时 更 新 数据 库 中 的 时 间 戳 ， 如 图 4-7 所 示 。 
人 | 
€ DH CC | localhost:3000 穴 | 四 吨 三 











The House-Sitter App 
[Stephan 引 


Taking care of Stephan's house 





Last visit: Sun Oct 05 2014 16:36:59 GMT+0200 (CEST) 
Plant color: red 

Instructions: 3 pots/week | Done 

Plant color: brown 


Instructions: keep humid [Done | 

















图 4-7 每 次 单 击 Done 按 钮 ， 时 间 蕉 在 屏幕 上 和 数据 库 中 都 会 得 到 更 新 


由 于 延迟 补偿 ， 本 地 Minimongo 实 例 中 的 值 首先 被 更 新 ， 结 果 会 立即 显示 。 在 同一 时 间 ， 更 
新 请 求 发 送 到 服务 器 ,在 那里 ,最 后 一 次 访问 日 期 将 被 持久 化 "。 如 果 到 服务 器 的 连接 丢失 ,Meteor 
会 将 更 新 存储 在 本 地 的 浏览 器 中 ， 在 连接 恢复 时 再 发 送 一 次 更 新 。 


4.4.7 ”向 集合 中 插入 新 数据 


随 着 业务 的 增长 ， 新 的 房屋 被 添加 ， 必 须 向 集合 中 添加 新 的 文档 。 一 般 来 说 ， 添 加 文档 使 用 
insert () 函数 。 文 档 的 每 个 字段 必须 单独 指定 ， 但 不 包含 _ia， 因 为 它 由 数据 库 自 动 分 配 : 






































Collection.insert ({field: "value"}); 
添加 新 房屋 到 集合 需要 一 个 新 的 模板 以 及 男 一 个 事件 映射 来 触发 这 个 插入 。 在 4.2.2 节 , 你 已 
经 建立 了 一 个 houseForm 模 板 ， 现 在 可 以 扩展 它 。 








说 明 我 们 还 没有 讨论 路 由 , 所 以 所 有 的 模板 都 显示 在 同一 个 视图 中 。 虽然 你 可 以 使 用 Session 
来 确定 需要 显示 哪些 模板 ， 但 首选 的 方法 是 使 用 路 由 。 你 可 以 跳 到 第 8 章 了 解 一 些 使 用 专 
用 视图 来 编辑 和 显示 数据 的 原则 。 


代码 清单 4-16 显 示 了 houseForm 模 板 , 它 包 含 一 个 视图 , 视图 中 的 表单 显示 了 房屋 文档 中 所 














GD 即 被 保存 到 数据 库 。 一 一 译 者 注 
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有 可 编辑 的 字段 。 为 了 让 事情 
入 字段 将 由 它们 的 ID 标识 。 


代码 清单 4-16 ”使 用 表单 添加 新 的 房屋 
<template name="houseForm"> 
<h3>Add a house</h3> 
<form id="houseForm"> 
Name <input id="house-name" 
Plant<br/> 
Color <input id="plant-color" 
INSCIUOtCEOTNS. <iNnout Td="plant 
<br/> 
DE/S 
<button id="saveHouse">Save 
</form> 
</template> 


下 一 步 ， 创 建 一 个 用 于 处 理 表单 的 事件 映射 (代码 清单 4-17 )。 当 表单 的 按钮 被 单 击 时 ， 浏 
览 器 的 默认 行为 是 发 送 表单 并 重新 加 载 一 个 页 面 。 因 为 你 正在 为 该 按钮 实现 自己 的 功能 ,所 以 必 
须 在 这 个 事件 上 调用 preventDefault ) 方 法 来 抑制 默认 的 和 J 为 。 使 用 jQuery， 你 可 以 获得 输入 
字段 的 所 有 值 并 把 它们 放 进 局 部 变量 


代码 清单 4-17 添加 一 个 新 房屋 的 事件 映射 


Template.houseForm.events({ 


简单 ， 让 我 们 限制 该 表单 只 能 添加 一 个 植物 到 一 个 房屋 "。 所 有 输 


type="text" placeholder="Name"><br/> 


type="text"> 


-instructions" type="text"> 


House</button> 






































'click pbutton#saveHouse': function (evt) { : 阻止 发 送 
evt .preventDefault (); 了 :; 表单 和 页 
使 用 jQuery var houseName = $('input[id=house-name] ') .val (); : 面 重 载 
获得 输入 var plantColor = $('input[id=plant-color]') .val(); 
字段 的 值 var plantIinstructions = $('input[id=plant-instructions]') .val(); 
Session.set('selectedHouselId', HousesCollection.insert({ < 一 
name: houseName, 
plants: [{ 
OLOr: DlantCoLlors 
instructions: plantIinstructions 
| 插入 一 个 新 的 文档 ， 将 
})); 返回 值 赋 给 selectedHouseld 
// empty the form 变量 ， 将 立即 显示 新 文档 的 内 容 
S(inpue) :val (ty) < | 清空 表 
} 单字 段 
过 
最 后 一 行 代码 做 两 件 事 。 首先 , 它 将 一 个 新 的 文档 插入 到 Housescollection, 该 文档 的 值 





为 表单 中 输入 字段 的 值 。 然 后 返回 新 文档 的 ID , 将 它 赋 值 给 selectedHouseId 会 话 变 量 。 
整个 页 面 的 选择 和 详细 视图 将 立刻 更 新 ， 显 示 新 的 房屋 。 


这 只 是 一 个 添加 房屋 的 很 简单 的 方式 ， 它 有 几 个 缺点 。 该 表单 不 允许 用 户 给 一 个 房屋 输入 多 























@ 别 担心 ， 你 很 快 就 会 创建 一 个 更 强大 的 方式 来 添加 你 喜欢 的 植物 。 
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个 植物 。 此 外 , 该 表单 只 能 够 添加 新 的 房屋 ( 虽然 你 可 以 很 容易 地 重用 它 , 用 来 编辑 现 有 的 房屋 )。 
在 接 下 来 的 部 分 ， 你 将 改进 这 个 例子 , 改进 这 些 缺 点 ， 重 构 一 些 代码 来 提高 效率 。 但 首先 让 我 们 
完成 基本 的 增删 改 查 。 


4.4.8 从 集合 中 删除 数据 
完整 CRUD? 的 最 后 一 步 是 从 数据 库 中 删除 一 个 记录 。 相 关 函 数 为 remove () : 


Collection.remove(id); 

类 似 于 update () 方 法 ，aelete() 需 要 一 个 唯一 的 ID 来 知道 要 删除 的 文档 。 多 个 文档 可 能 
只 能 从 服务 器 上 删除 ， 当 我 们 讨论 方法 的 时 候 ， 会 关注 这 一 点 。 

对 于 HTML, 要 人 允许 房屋 被 删除 ,所 要 做 的 就 是 在 showHouse 模 板 中 添加 一 个 按钮 。 当 按钮 
被 单 击 时 ， 通 过 ID 来 确定 要 删除 的 房屋 。 在 Meteor 中 ， 至 少 有 三 种 方法 来 做 到 这 一 点 。 
口 如 果 HTML 按 钮 有 aata-idq 属 性 ， 你 可 以 像 确定 植物 ID 那样 ， 以 同样 的 方式 查询 其 内 容 。 
口 如 果 当 前 选 定 的 房屋 ID 存储 在 session 对 象 中 , 你 可 以 像 更 新 房屋 时 处 理 Done 按 钮 那样 ， 
以 同样 的 方式 使 用 它 。 
口 如 果 模 板 的 数据 上 下 文 提 供 了 该 ID ， 你 可 以 直接 访问 它 。 

我 们 已 经 介绍 了 前 两 个 。 这 一 次 ,ID 已 经 是 click 事 件 发 生 的 数据 上 下 文中 的 一 部 分 了 。 这 
意味 着 你 可 以 简化 确定 要 删除 文档 的 方法 ， 即 选择 第 三 种 方法 。 代 码 清单 4-18 显 示 了 如 何 将 按钮 
添加 到 模板 中 。 













































































说 明 虽然 不 是 必要 的 ， 但 你 应 该 考虑 添加 一 个 data-id 属 性 到 删除 按钮 ， 这 样 可 提供 一 些 可 
追溯 性 ， 使 调试 更 容易 。 


代码 清单 4-18 ”添加 一 个 删除 按钮 从 数据 库 中 删除 房屋 


<template name="showHouse"> 
{{#with house}} 


i | 在 else 标 签 之 前 
<button id="delete">Delete this house</button> Ne] 添加 按钮 
{{else}} 
{{/with}} 
</template> 





showHouse 模 板 还 没有 任何 事件 映射 , 所 以 单 击 按钮 不 会 做 任何 事情 。 让 我 们 在 client.js 中 创 
建新 的 事件 映射 。 代 码 清单 4-19 显 示 了 执行 Collection.remove() 的 代码 。 你 要 把 它 包 在 一 个 
确认 对 话 框 内 ， 以 防止 用 户 不 小 心 删除 房屋 。 























人 创建 ( Create )、 读 取 ( Read )、 更 新 ( Update ) 和 删除 ( Delete )， 持久 性 数据 基本 操作 的 通用 名 字 。 
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代码 清单 4-19 删除 一 个 房屋 的 事件 映射 


Tempblate.showHouse.events ({ 这 是 当前 的 数据 上 下 文 : 
Cli batbontaelete : function (evt) { 选 定 的 房屋 文档 
VAar 1d = thiss 1d = 
var deleteConfirmation = confirm('Really delete this house?'); < 一 
if (deleteConfirmation) { 
HousesCollection.remove (id); < 一 在 真正 删除 
2 在 服务 器 端 和 文档 之 前 显 
) 客户 端的 集合 示 一 个 确认 
1); 中 删除 文档 对 话 框 


























注意 , 你 不 需要 像 把 植物 设置 为 已 浇 水 状态 时 那样 去 捕捉 事件 和 读 取 data-id 属 性 。 你 可 以 
直接 访问 包含 在 当前 选 定 房屋 文档 中 的 所 有 信息 ， 包 括 _iq。 

祝贺 你 ， 你 现在 能 够 使 用 Meteor 执 行 所 有 基本 的 数据 操作 了 1! 这 一 切 只 需要 大 约 50 行 的 
HTML 代 码 和 大 约 100 行 的 JavaScript 代 码 。 深 呼吸 ， 让 自己 放松 一 下 。 

现在 , 你 已 经 熟悉 Session 对象 的 使 用 , 能 在 MongoDB 数 据 库 中 使 用 collection 以 各 种 方 
式 存 储 、 操 作 和 检索 数据 了 。 虽 然 这 个 应 用 的 主要 功能 已 经 存在 ,但 你 仍然 有 一 些 工 作 要 做 。 根 
据 你 的 喜好 ， 你 可 以 开始 确保 应 用 的 安全 性 ， 这 将 需要 用 户 和 账户 〈 人 参见 第 6 章 )。 第 二 个 选择 是 
在 应 用 中 添加 路 由 功能 ,以 便 添加 新 房屋 的 表单 和 显示 房屋 细节 的 内 容 不 在 同一 个 页 面 上 ( 参见 
第 8 章 ), 但 我 们 应 首先 解决 该 应 用 一 些 功 能 上 的 不 足 : 为 现 有 的 和 新 的 房屋 添加 和 删除 任意 数量 
的 植物 。 

在 下 一 章 中 , 我 们 将 使 用 更 具 响 应 性 的 做 法 来 克服 应 用 目前 的 一 些 缺 点 , 方法 是 利用 Meteor 
的 响应 性 核心 原则 ， 而 不 是 遵循 一 些 老 习惯 ， 如 使 用 jQuery 进行 复杂 的 DOM 操 作 。 

































































4.5 总 结 


在 本 章 中 ， 你 已 经 了 解 到 : 

口 响应 式 数 据 源 会 意识 到 它 依赖 的 计算 ; 

口 在 响应 性 上 下 文中 ， 当 数据 源 发 生变 化 时 ， 函 数 会 重新 运行 ; 

口 Tracker.autorun() 通 过 提供 一 个 响应 性 上 下 文 ， 可 以 将 任何 水 数 变 成 响应 式 计 算 ; 
口 易 失 性 数据 可 以 存储 在 session 对 象 中 的 键 一 值 对 中 ; 

口 持久 性 数据 存储 在 MongoDB 的 collection 中 ; 

口 Meteor 会 自动 发 布 所 有 Collection 给 每 一 个 客户 ， 除 非 autopublish 包 被 删除 ; 

口 在 将 一 个 应 用 投入 生产 之 前 ， 必 须 删 除 autopublish 和 insecure 包 。 
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本 章 内 容 
口 响应 式 表单 的 构建 
口 使 用 响应 式 数据 绑 定 更 新 视图 

口 不 同步 的 或 本 地 的 集合 

口 在 表单 中 显示 集合 数据 ， 并 进行 响应 性 更 新 5 
D 实现 一 个 简单 的 通知 系统 














在 第 4 章 中 ， 你 创建 了 一 个 功能 齐全 的 基本 应 用 ， 人 允许 用 户 选 择 、 查 看 、 添 加 和 删除 房屋 。 
因为 使 用 了 响应 式 数 据 源 ， 所 以 你 不 必 操 纵 DOM 树 ， 比 如 创建 一 个 新 房屋 的 时 候 在 下 拉 列 表 中 
添加 一 个 新 的 option 元 素 ，Meteor 的 响应 性 帮助 你 做 了 这 些 。 

前 端 开发 中 最 常用 的 方法 是 手动 进行 DOM 操 作 ， 但 它 繁琐 上 且 容 易 出 错 。 在 大 多 数 框 架 中 ， 
数据 从 后 端 获取 ,然后 以 一 定 方式 插入 到 DOM。 如 果 一 个 新 的 数据 库 记录 发 送 到 客户 端 , jQuery 
这 样 的 库 可 用 于 添加 新 的 1i 元 素 或 新 建 表 格 的 一 行 。 虽然 这 种 方法 简单 , 但 它 往 往 使 代码 过 于 复 
杂 ， 并 强制 你 显 式 地 处 理 页 面 内 发 生 的 所 有 变化 。 很 多 人 把 前 端 编码 和 DOM 操 作 联系 起 来 ， 但 
Meteor 让 你 只 专注 于 数据 ， 它 会 处 理 视 网 和 模板 的 任何 更 新 。 在 本 章 中 ， 你 将 利用 响应 式 数 据 绑 
定 ， 使 用 有 限 的 代码 ， 使 应 用 更 健壮 。 

本 章 将 向 你 展示 如 何 增强 现 有 的 应 用 , 使 其 能 够 处 理 更 复杂 的 数据 结构 。 你 将 把 所 有 的 交互 
限制 在 最 小 的 DOM 块 内 。 为 了 这 样 做 ， 需 要 利用 Meteor 数 据 库 无 处 不 在 的 原则 ， 并 使 用 只 存在 
于 客户 端的 本 地 集合 。 这 样 ， 你 可 以 为 一 个 房屋 添加 和 删除 任何 数量 的 植物 。 此 外 ， 你 将 实现 一 
个 初步 的 通知 系统 ， 确 保 未 保存 的 更 改 不 会 意外 丢失 。 在 本 章 的 最 后 ， 你 将 能 够 创建 由 响应 式 数 
据 源 支 持 的 全 响应 式 前 端 。 


5.1 响应 式 编辑 的 工作 流程 


在 将 一 些 高 级 的 Meteor 概 念 应 用 在 房屋 保姆 应 用 上 之 前 , 让 我 们 重 温 用 户 和 数据 库 之 间 的 整 
个 信息 流 (图 $-1 )。 

选择 一 个 房屋 时 , 用户 可 能 会 改变 它 的 内 容 , 例如 添加 或 删除 植物 ( 步骤 1 )。 特 别 是 处 理 敏 
感 数据 时 ,应 用 将 在 浏览 器 中 验证 传人 的 数据 ( 步骤 2 )。 如 果 所 有 的 数据 都 是 有 效 的 ， 就 把 它 存 
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储 在 本 地 的 微型 数据 库 中 〈 步 又 3 )。 但 此 时 数据 仍然 是 易 失 的 ， 它 只 存在 于 用 户 的 浏览 器 中 , 所 
以 这 仅仅 是 一 个 实际 存储 过 程 的 模拟 。 如 果 用 户 在 这 时 关闭 他 的 浏览 器 , 数据 将 不 会 存储 到 服务 
器 上 ， 虽 然 浏 览 需 视 岁 已 经 更 新 〈 步 又 4 )。 

6. 验证 数据 2. 验证 数据 








5. 调用 方法 存储 文档 




















| - | 8. 确认 成 功 
| 要 
! ee | 
| | Livequery 监 控 所 有 
的 变化 ， 并 把 它们 推 
送 到 订阅 的 客户 端 





图 5-1 ”响应 式 编辑 的 工作 流程 


在 成 功 的 模拟 之 后 ， 数 据 被 发 送 到 服务 器 上 ， 并 要 求 保存 它 〈 步 骤 5 )。 再次， 进行 验证 ( 步 
又 6 )， 然 后 实际 的 存储 过 程 发生 〈 步 又 7 )。 最后， 操作 的 结果 ， 无论 是 失败 还 是 成 功 ,被 发 送 回 
客户 端 ( 步骤 8 ), 所 有 其 他 正在 查看 当前 被 更 新 文档 的 用 户 可 以 在 屏幕 上 看 到 实时 更 新 。Livequery 
组 件 不 断 监视 数据 库 的 变化 ， 并 跟踪 所 有 当前 的 订阅 客户 端 ”。 

到 目前 为 止 , 第 4 章 构建 的 房屋 保姆 应 用 只 允许 你 的 新 客户 有 一 株 植 物 。 你 不 仅 需 要 能 够 为 
拥有 多 个 植物 的 客户 服务 ,而且 还 要 能 够 为 有 不 同 数 量 植 物 的 客户 服务 。 现 有 应 用 的 第 一 个 改进 
是 必须 允许 编辑 现 有 的 文档 ， 同 时 也 允许 每 个 房屋 中 有 任意 数量 的 植物 。Blaze 模 板 和 响应 式 数 
据 源 的 组 合 允 许 你 实现 响应 式 表单 编辑 ， 而 这 只 需要 儿 行 代码 。 

一 旦 引入 响应 式 编辑 , 你 得 考虑 到 Livequery 引 发 的 即时 更 新 可 能 不 总 是 可 取 的 。 有 时 会 有 两 
个 人 编辑 相同 的 文档 , 所 以 你 需要 一 种 方法 来 进行 沟通 , 说 明 别 人 已 经 改变 了 你 目前 正在 编辑 的 
文档 。 你 不 应 该 因为 服务 器 的 数据 更 新 了 就 放弃 所 有 未 保存 的 更 改 。 所 有 的 本 地 更 改 应 先 存 储 在 
一 个 临时 环境 中 , 它 会 带 来 性 能 上 的 好 处 , 也 会 给 你 一 个 安全 的 网 络 。 你 还 将 实现 一 个 通知 系统 ， 
为 用 户 高 亮 显 示 更 新 。 


5.2 ”响应 式 前 端 与 DOM 操作 


大 多 数 前 端 工程 师 通常 首 先 考虑 DOM。 他 们 考虑 如 何以 及 在 哪里 放置 元 素 ， 如 何 序列 化 数 
据 并 将 它们 发 送 到 REST 接 口 。jQuery 是 实现 这 些 任务 的 一 个 方便 的 工具 ， 对 很 多 人 来 说 ， 它 是 
前 端 开发 和 DOM 操 作 的 同义词 。 

当 服 务 器 和 客户 端 使 用 不 同 的 语言 和 框架 时 , 你 经 常会 发 现 自己 面临 的 问题 是 如 何 将 服务 器 












































































































































我 们 将 在 第 7 章 更 详细 地 讨论 订阅 和 发 布 。 
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接收 到 的 数据 映射 到 实际 的 视图 。 如 果 没 有 简单 可 行 的 整合 ，jQuery 总 是 可 以 用 来 添加 和 删除 
DOM 的 节点 。 不 幸 的 是 ， 即 使 是 一 些小 任务 ， 手动 改变 DOM 也 会 变 得 相当 混乱 ， 这 就 是 我 们 要 
向 函数 响应 范式 转变 的 原因 。Meteor 也 不 例外 地 顺应 了 这 一 发 展 。 

让 我 们 来 比较 这 两 种 情况 。 考 虑 一 个 简单 的 表单 ,用 来 在 我 们 的 房屋 里 添加 和 删除 植物 。 一 
个 按钮 用 来 删除 现 有 的 植物 ; 另 一 个 用 来 添加 一 个 fieldqset 表 单 以 输入 植物 的 细节 。 图 5-2 中 的 
场景 A 显 示 了 删除 一 个 DOMT 点 时 的 相关 代码 。 单 击 按钮 将 删除 一 个 表单 的 fielaqset (被 单 击 
按钮 的 父 表单 )。 它 不 会 影响 该 植物 在 其 他 地 方 的 显示 ， 所 以 在 更 复杂 的 视图 中 ， 需 要 添加 额外 
的 remove () 操 作 ， 例 如 ， 出 现在 同一 页 上 的 房屋 文档 的 预览 。 添 加 一 个 新 植物 要 引入 更 多 的 复 
杂 性 ， 它 需要 插入 定义 植物 表单 字段 的 整个 HTML。 这 一 行 很 长 ， 而 且 如 果 你 决定 使 用 不 同 的 类 
或 添加 更 多 的 字段 来 调整 表单 代码 ， 这 将 很 容易 出 错 。 

场景 A: 操作 DOM 


| $ (evt.currentTarget) .parent () .remove(); 



























































删除 一 个 


Plants DOM 节 点 
Color |Red 




















Color White 








$("#houseForm fieldset:last") .after (" 
<fieldset id='plant-3'> 
Color <input type='text’' class='color'> 
Instructions <input type='text' class='instructions'> 
</fieldset> 
VE 











场景 B: 操作 DOM 下 的 数据 结构 






plants.splicel(lindex, 1); 
LocalHouse.updatel(id, {$set: {'plants': plants}}) 






删除 一 个 








| | Remove Plant 







| Instructions water daily Remove Plant 





Add Plant 
添加 一 个 LocalHouse.update (id, 
对 象 属性 {Spush: {'plants': 





FE 人 二 交感 二 半 


} 


} 
) 





图 $-2 ”比较 DOM 操 作 和 响应 式 数 据 更 新 
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DOM 操 作 可 能 适合 小 的 前 端 改 动 , 但 是 编写 大 型 应 用 软件 时 ， 维 护 这 种 代码 将 是 一 个 挑战 。 
就 是 Meteor 前 后 端 之 间 无 颖 集成 有 用 的 地 方 。 使 用 Meteor， 你 可 以 直接 处 理 数据 ， 让 框架 为 你 
所 有 的 DOM 了 映射 。 数 据 结构 的 变化 会 自动 触发 必要 的 DOM 更 新 。 

每 个 房屋 都 已 经 存储 为 数据 库 中 的 文档 或 对 象 了 。 为 什么 不 基于 此 在 这 些 对 象 上 进行 工作 而 
去 关心 HTML 标 签 ? 使 用 Meteor, 很 容易 这 样 做 ,你 不 仅 不 必 考 虑 使 用 jQuery 来 进行 内 容 映 射 ， 
且 也 可 以 免费 获得 响应 式 数 据 绑 定 (关于 数据 绑 定 的 更 多 信息 ， 可 参考 下 面 的 “双向 数据 绑 定 
向 应 性 ”)。HTML 表 单 只 是 代表 house 对 象 的 另 一 个 视图 。 单 击 按钮 不 会 触发 DOM 操 作 , 但 会 
变 一 个 对 象 ， 如 图 5-2 场 景 B 所 示 。 

正如 所 见 ， 它 不 仅 涉 及 较 少 的 代码 ， 而 且 也 更 好 地 把 数据 和 表现 分 离 。 作 为 一 个 JavaScript 
发 者 ， 你 已 经 熟悉 操作 对 象 。 剩 下 的 就 是 如 何 通过 Meteor 将 数据 作为 一 个 对 象 传递 到 前 端 。 

在 这 个 房屋 保姆 应 用 的 扩展 示例 中 ， 你 将 只 依赖 于 四 个 数据 源 : 

口 房屋 集合 ( HouseCollecion ) 用 于 服务 器 端的 MongoDB 和 集合 ， 用 于 持久 化 房屋 ; 







































































D session.get('selectedHouseId') 用 于 跟踪 当前 选择 的 房屋 ; 
口 Session.get ('notification') 一 一 用 于 存储 和 显示 通知 消息 ; 














口 LocalHouse 一 一 本 地 的 Minimongo 和 集合 ， 只 存在 于 浏览 器 内 部 ， 作 为 更 新 发 送 到 服务 器 
之 前 的 临时 数据 库 。 
前 两 个 已 经 在 上 一 章 中 出 现 了 , 你 将 在 本 章 中 添加 另外 两 个 。 你 也 可 以 去 掉 用 于 跟踪 菜花 是 

已 经 浇 过 水 的 按钮 ,因为 你 将 只 专注 于 客户 或 房屋 记录 管理 。 这 样 ， 你 会 使 用 两 个 列 来 改进 布 

。 其 中 房屋 文档 的 内 容 在 左边 ,编辑 表单 在 右边 。 另外， 你 可 以 在 本 章 附带 的 示例 代码 中 找到 

里 使 用 的 样式 。 



































双向 数据 绑 定 与 响应 性 


一 些 流 行 的 框架 (如 Angular 或 Ember ) 提出 了 一 个 称 为 双向 数据 绪 定 〈two-way data 


binding ) 的 概念 ， 用 户 界面 的 变化 会 影响 底层 的 数据 模型 ， 反 之 亦 然 。Meteor 不 依赖 于 这 样 的 
绑 定 ， 而 是 使 用 了 响应 性 。 但 其 中 真正 的 区 别 是 什么 呢 ? 


使 用 传统 服务 器 端 语 言 ( 如 PHP 或 Java ) 时, 应 用 从 数据 库 中 检索 数据 , 将 其 转换 为 HTML 


并 发 送 到 浏览 器 进行 显示 。 服务器 可 以 使 用 一 些 代码 ， 比 如 Ajax， 查询 数据 库 的 变化 ， 重新 泻 
染 , 并 发 送 一 个 更 新 的 视图 到 浏览 器 。 如 果 数据 以 表单 形式 显示 出 来 ,用户 可 以 进行 多 次 更 改 ， 
并 且 不 会 影响 数据 库 内 容 。 事 实 上 ， 表 单数 据 必 须 先 发 送 到 服务 器 进行 处 理 和 更 新 。 然 后 ， 服 
务 器 将 数据 存储 在 数据 库 , 检索 它 ， 并 向 浏览 器 发 送 一 个 更 新 的 视图 。 由 于 数据 从 数据 提供 者 
向 消费 者 流动 ， 这 有 时 被 称 为 单 向 数据 绑 定 。 
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视 视图 的 泻 染 只 在 
em 
演 染 过 程 获 取 数 


>: 据 和 模板 信息 
数据 模板 单 向 数据 绑 定 


使 用 双向 数据 绑 定 时 ， 数 据 流 是 连续 的 。 视 图 中 的 每 一 个 变化 都 会 回流 到 实际 数据 中 ， 反 
之 亦 然 。 这 意味 着 如 果 一 个 表单 字段 被 用 户 更 新 ， 则 底层 的 数据 提供 者 也 发 生 了 变化 。 如 果 表 
单数 据 也 显示 在 网 站 上 其 他 地 方 的 话 ， 这 种 行为 是 可 以 观察 到 的 ， 因 为 它 会 立即 更 新 。 











双向 数据 绑 定 


在 实践 中 , 这 些 双 向 数据 绑 定 可 能 有 不 可 预知 的 后 果 ， 尤 其 是 有 多 个 实例 时 ， 每 个 实例 可 
能 会 触发 其 他 实例 的 更 新 。 

虽然 响应 性 不 需要 与 任何 数据 绑 定 相 关 ，, 但 它 很 容易 用 于 事件 监控 , 并 在 数据 变化 时 使 用 
计算 来 自动 更 新 视图 。 事实 上 , 使 用 响应 式 数据 源 是 实现 类 似 双 向 数据 绑 定 行为 的 一 个 简单 方 
法 ， 它 通过 模板 辅助 函数 来 显示 数据 ， 使 用 事件 来 更 新 数据 源 。 数 据 变 化 时 ， 你 不 需要 任何 代 
码 来 更 新 视图 ， 因 为 Blaze 引 擎 会 帮 你 做 这 件 事 。 如 果 做 得 很 巧 妨 ， 你 黄 至 不 需要 提供 代码 来 
将 数据 发 送 回 服务 器 ， 而 这 件 事 在 使 用 客户 端 框架 时 则 必须 去 做 。 

如 果 你 需要 更 高 级 的 前 端 功 能 或 双向 数据 绑 定 ,使 用 包 来 将 Meteor 与 其 他 前 端 框 架 ( 如 
Angular 或 Ember ) 结合 也 是 有 可 能 的 。 
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5.3 ”在 本 地 集合 中 进行 临时 更 改 


第 4 章 使 用 了 两 种 不 同类 型 的 响应 式 数据 源 : session 和 collection。 在 实现 任何 响应 式 
编辑 之 前 ， 你 必须 决定 使 用 哪个 来 保存 房屋 数据 。 你 可 以 很 容易 地 使 用 collection 对 象 ， 因 为 
所 有 的 房屋 都 已 经 存储 在 里 面 。 这 样 , 你 可 以 扔 掉 大 部 分 代码 , 数据 库 中 总 是 有 最 新 编辑 的 状态 。 
然而 使 用 服务 器 端 collection 有 两 个 缺点 。 
口 每 个 变化 ， 即 按键 ， 会 发 起 一 个 数据 库 写 操作 ， 这 会 给 网 络 和 服务 器 带 来 压力 。 单 个 客 
户 没什么 问题 ， 但 如 果 有 成 千 上 万 的 房屋 保姆 要 更 新 他 们 客户 的 房屋 ， 你 可 以 预见 会 有 
大 量 的 负荷 ， 这 最 好 能 够 避免 。 

口 如 果 不 小 心 更 改 错误 ， 将 没有 回 滚 。 但 你 仍然 希望 用 户 可 以 按 下 一 个 按钮 以 保存 数据 ， 
以 避免 添加 复杂 的 撤消 程序 。 

你 可 以 使 用 session 来 保存 数据 库 对 象 , 但 这 意味 着 你 必须 使 用 不 同 的 方法 在 这 些 数据 上 工 
作 ， 这 影响 了 你 重用 现 有 的 代码 。 

所 以 你 需要 一 个 中 间 数 据 存储 ,该 存储 只 保存 编辑 过 程 中 的 数据 ， 一旦 Save (保存 ) 按钮 被 
单 击 ， 就 将 其 交 给 collection 。 要 遵守 第 一 点 ， 你 没有 理由 发 送 每 一 步 编辑 的 临时 的 
Collection 内 容 到 服务 器 (虽然 你 可 以 这 样 做 ， 如 果 你 想 建立 一 个 类 似 于 谷歌 文档 的 自动 保存 
的 变 体 )。 为 了 避免 任何 中 间 格 式 ， 你 可 以 使 用 collection 的 一 个 特殊 变 体 作为 一 个 临时 实例 : 
一 个 本 地 的 或 没有 同步 的 集合 。 其 数据 流 如 图 5-3 所 示 。 


LocalHouse. 
findone () 






































编辑 Stephan 的 房间 











HousesCollection. 


ng findOne () rpgsrsneeig Name|stephan 
Ss i ' 
| f 加 人 四 | 


Color Red 
Instructions 3 pots/week 






| 没有 同步 的 本 地 | 








| 同步 的 MongoDB | _Remove Plant 
| 集合 ! | 集合 Minimongo ! LocalHouse. 
| 六 | ee ! update() Color white 
实例 ! Instructions water daily 
BUDS | WL Remove Plant 
服务 器 端 





HouseCollection.upsert () 





图 5-3 ”将 本 地 集合 LocalHouse 作 为 房屋 文档 的 一 个 临时 环境 

本 地 集合 的 优点 是 , 它们 只 存在 于 浏览 器 的 内 存 中 。 这 意味 着 它们 是 快速 的 ,其 写 操 作 是 廉 
价 的 ， 因 为 没有 网 络 延 迟 或 磁盘 IO 来 减 慢 这 些 操作 。 它 还 有 一 个 额外 的 好 处 ， 就 是 所 有 数据 和 
服务 器 上 的 MongoDB 集 合 具 有 完全 相同 的 格式 。 
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说 明 使 用 本 地 临时 集合 ， 需 要 处 理 服务 器 内 容 更 改 时 导致 的 潜在 的 数据 不 一 致 性 。 我 们 将 通 
过 实现 一 个 通知 系统 来 解决 这 个 问题 。 





作为 本 章 开发 的 起 点 ， 让 我 们 基于 上 一 章 houseSitter 应 用 的 代码 ， 建 立 一 个 新 的 houseSitter2 
用 。 需 要 修改 的 文件 是 客户 端 文件 clientjs 和 templates.html。 
当 你 实例 化 一 个 新 的 未 命名 的 Mongo .collection 或 显 式 地 将 名 称 设置 为 nul1 时 ， 一 个 未 
同步 的 或 本 地 的 集合 也 会 被 建立 。 这 可 以 在 服务 器 端 或 客户 端 环 境 中 完成 : 

LocalHouse = new Mongo.Collection (null); 

要 使 LocalHouse 和 集合 为 客户 端 专用 ， 必须 把 代码 添加 到 client.js 文 件 。 每 个 客户 端 都 有 自己 
的 LocalHouse 实 例 ， 单 击 Save 按 钮 会 触发 一 个 推送 ， 将 更 改 发 送 到 服务 器 ( 而 服务 器 将 更 新 所 
有 客户 端 )。 

你 还 将 为 selectedHouseIgd 添 加 一 个 默认 值 以 使 我 们 的 代码 更 容易 理解 ， 添 加 一 个 
newHouse 对 象 来 定义 数据 库 记 录 的 结构 。 lastsave 和 status 这 两 个 字段 ， 使 你 有 更 好 的 机 会 
来 比较 本 地 和 服务 器 环境 中 的 数据 。 这 种 能 力 会 在 以 后 派 上 用 场 的 。 代 码 清单 5-1 显 示 了 更 新 后 
的 client.js 文 件 的 前 几 行 代码 。 


代码 清单 5-1 设置 本 地 集合 
LocalHouse = new Mongo.Collection (null); 
Var newHouse = { 
ds 
lJastsave: 'never', 
status: 'unsaved' 
> 
Session.setDefault ('selectedHouseId', ''); 
一 旦 建立 起 集合 , 选择 一 个 房屋 时 会 在 服务 器 数据 库 中 进行 查找 , 并 将 当前 选 定 卫 的 文档 揪 
人 到 LocalHouse 集 合 。 这 意味 着 我 们 需要 重新 审视 selectHouse 模 板 中 的 事件 。 
到 目前 为 止 ， 在 下 拉 列 表 中 change 事 件 做 的 唯一 事情 是 设置 Session 的 值 ， 让 我 们 改进 现 
有 的 代码 。 代 码 清单 5-2 显 示 了 需要 的 更 改 。 当 给 newIdq 设 置 一 个 新 值 时 ， 事 情 会 变 得 有 点 复杂 ， 
我 们 来 从 内 到 外 地 看 看 代码 。finaone () 在 Housescollection 集 合 上 执行 ， 返 回 一 个 基于 当 
前 选 定 ID 的 文档 。 如 果 选 择 了 空 的 下 拉 选 项 ， 它 将 找 不 到 文档 。 在 这 种 情况 下 ， 使 用 newHouse 
对 象 来 代替 。 无 论 哪 种 方式 ， 在 更 改 下 拉 选 项 后 ， 你 会 得 到 一 个 文档 。 
因为 你 在 处 理 一 个 现 有 的 文档 ( 这 将 需要 使 用 update () ) 或 新 文档 ( 必须 使 用 insert () )， 
所 以 你 可 以 用 更 灵活 的 upsert () 方 法 。 如 果 它 基于 _ia 找 到 了 一 个 文档 ， 就 会 执行 一 个 更 新 ; 
否则 ， 它 将 插入 一 个 完整 的 新 文档 。upsert () 在 执行 更 新 时 会 返回 受 影响 文档 的 数量 ; 插入 新 
文档 时 , 它 会 返回 一 个 具有 两 个 属性 的 对 象 : numberAffected 和 insertedIgd。 无 论 哪 种 方式 ， 
返回 的 insertedId 值 会 赋 给 newId， 这 将 成 为 selectedHouseId 的 新 值 。 如 果 upsert () 不 需 


澡 
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要 在 本 地 集合 中 插入 任何 新 文档 ， 则 意味 着 已 选择 人 D 的 文档 已 经 存在 ， 它 应 作为 newId 来 使 用 。 
代码 清单 5-2 ”使 用 change 事 件 将 一 个 房屋 添加 到 本 地 的 临时 集合 





Tempblate.selectHouse.events ({ 插入 一 个 新 的 文件 ， 如 果 
change #selectHouse': function (evt) { _id 存 在 ， 则 更 新 它 

Var selectedId = evt.currentTarget .value; 

Var newId = LocalHouse.upsert! < 一 如 果 没 有 找到 文档 ， 
selectedIdqd, 设置 reactiveHouse- 
HousesCollection.findOone(selected1Id) || newHouse Object 为 newHouse 

) .insertedId; 加 | 对 象 
if (!newId) newId = selectedId; ee 
Session.set('selectedHouseld', newI1d); 

} 如 果 没 有 插入 发 生 , 你 可 
1 以 直接 使 用 selectedld 

















现在 ， 要 向 表单 添加 编辑 功能 ， 有 两 个 地 方 需要 完整 的 house 细 节 : showHouse 模 板 和 
houseForm。 使 用 一 个 可 以 在 任何 模板 中 使 用 的 全 局 辅助 函数 , 比 在 编辑 模板 中 创建 另 一 个 辅助 
函数 来 返回 房屋 的 内 容 要 更 高 效 。 

Template.registerHelper() 人 允许 你 创建 全 局 辅助 函数 ， 你 将 使 用 它 来 让 { {selected- 
House}} 可 从 应 用 的 所 有 模板 中 引用 (代码 清单 5-3 )。 请 注意 ， 该 辅助 函数 不 会 像 以 前 那样 在 服 
务 器 的 数据 库 上 执行 查找 ， 它 直接 从 LocalHouse 返 回 内 容 。 


代码 清单 5-3 ”返回 编辑 对 象 的 全 局 辅助 函数 
Template.registerHelper('selectedHouse', function () { 
return LocalHouse.findOone(Session.get ('selectedHouselId')); 


和 这 


下 一 步 你 可 以 更 新 snowHouse 模 板 , 以 使 用 全 局 辅助 函数 而 不 是 使 用 基于 特定 模板 的 辅助 
数 house。 找 到 {{#with house}} 标 签 ， 对 它 进行 修改 ， 如 下 面 的 代码 清单 所 示 。 


代码 清单 5-4 使 用 {{#with}} 设 置 数据 上 下 文 为 全 局 辅助 函数 selectedHouse 的 返回 值 
<template name="showHouse"> 
{{#with selectedHouse}} 
<h2>Taking care of {{name}}'s house</h2> 








































































































员 














(tywith]] 

</template> 

作为 showHouse 重 构 的 总 结 你 可 以 完全 删除 Template .ShowHouse.helpers 的 代码 。 

如 果 使 用 下 拉 列 表 来 选择 一 个 房屋 , 现在 它 的 名 称 和 植物 的 细节 应 该 像 以 前 一 样 显示 , 只 是 
这 一 次 它们 来 自 本 地 的 集合 ， 而 不 是 服务 器 。houseForm 现 在 还 没有 显示 选 定 房屋 的 任何 数据 ， 
因为 它 还 没有 数据 上 下 文 。 你 可 以 使 用 和 上 面相 同 的 方法 (添加 {{#with selectedHouse}} 
到 模板 )， 或 在 body 中 包含 模板 时 直接 提供 数据 上 下 文 。 而 后 者 只 需要 在 代码 中 添加 一 个 单词 ， 
不 需要 更 多 的 修改 : 


{{> houseForm selectedHouse }} 
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为 了 保持 一 致 性 ， 让 我 们 继续 使 用 { {#with}} 语 法 。 此 外 ， 如 果 你 以 后 决定 将 模板 放 入 单独 
的 文件 , 这 样 做 将 更 容易 理解 给 定 的 数据 上 下 文 , 因为 它 包 含 在 模板 中 , 而 不 是 从 父 模 板 中 继承 的 。 


5.4 在 表单 中 显示 集合 数据 


现在 ， 在 输入 字段 中 还 没有 显示 数据 ， 所 以 必须 向 每 个 字段 添加 值 属 性 。 此 外 ， 你 还 需要 能 
够 显示 任何 数量 的 植物 。 代 码 清单 5-5 显 示 了 更 新 过 的 代码 。 

为 了 在 视觉 上 更 好 地 组 织 表单 ， 可 将 每 组 输入 放 入 一 个 fielgset。 这 样 ， 你 可 以 很 容易 地 
知道 哪个 指示 属于 哪 一 种 植物 。 此 外 , 你 会 像 折 分 showHouse 模 板 那样 进行 模板 拆 分 。 一 个 新 的 
plantFieldset 模 板 将 用 于 每 个 植物 。 为 了 删除 植物 , 你 需要 在 每 个 植物 的 fieldset 中 添加 一 
个 按钮 ， 然 后 在 表单 的 Save 按 钮 之 前 放置 男 一 个 按钮 来 添加 新 的 植物 ( 图 5-4 )。 


























Edit Stephan's house 











新 的 添加 和 
删除 按钮 


图 5-4 ”更 新 过 的 表单 ， 使 用 fieldsets， 有 添加 /删除 植物 的 按钮 
最 后 , 为 了 在 输入 字段 中 显示 现 有 的 数据 ,每 个 输入 从 一 个 相关 表达 式 得 到 新 的 属性 值 。 最 
后 ， 改 变通 用 的 Adding a house( 添加 房屋 ) 的 标题 ， 在 标题 中 提 到 当前 房屋 的 名 称 ( 见 下面 的 
代码 清单 )。 


代码 清单 5-5 在 HTML 表单 中 显示 多 个 植物 的 模板 代码 


























更 改 标题 以 
<template name="houseForm"> 引入 名 称 
{{#with selectedHouse}} < 一 

<h3>Edit {{name}}'s house</h3> 
使 用 全 局 <form id="houseForm"> les 
辅助 函数 <fieldset id="house-name"> < 一 
设置 数据 Name <input id="house-name" class="name" type="text" 
上 下 文 placeholder="Name" value="{{name}}"><br/> 二 == 

</fieldset> 现 有 的 数据 被 赋值 

<label>Plants</label> 给 value 属 性 


{{#each plants}} 
{{> plantFieldset}} 
{{/each}} 
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<button class="addPlant">Add Plant</button> 
<br/> 
<button id="save-house" data-id="{{_id}}">Save House</button> 
</form> 
Win 
除 植 物 的 
按钮 <template name="plantFieldset"> 
<fieldset> 
Color <input class="color" type="text" value="{{color}}"> 现 有 的 数据 
Instructions <input class="instructions" type="text" 被 赋值 给 
value="{{instructions}}"> value 属 性 
<button class="removePplant">Remove Plant</button> 
</fieldset> 
</template> 


让 我 们 重新 审视 一 下 代码 。 你 的 目标 是 响应 式 数据 绑 定 , 因此 必须 在 应 用 代码 中 以 某 种 方式 
来 创建 映射 ,使 得 当前 房屋 对 象 的 每 个 属性 都 映射 到 一 个 唯一 的 HTML 元 素 。 这 一 点 是 可 以 验证 
的 ， 因 为 每 个 数据 属性 ( 如 名 称 和 所 有 植物 的 详细 信息 ) 可 以 正确 显示 。 还 必须 有 一 种 方式 来 唯 
一 地 将 HTML 元 素 映射 回 数据 对 象 , 这 一 点 目前 还 没有 做 到 。 除了 输入 值 , 每 种 植物 的 fieldqset 
看 起 来 完全 相同 ， 所 以 你 还 需要 用 一 个 唯一 的 标识 符 来 标记 它 。 你 可 以 定义 color 作 为 一 个 唯 
的 字段 ,并 添加 验证 代码 以 确保 不 会 有 两 个 相同 颜色 的 植物 , 但 这 不 是 一 个 非常 强大 的 方法 。 可 
能 有 些 房屋 ， 它 们 有 两 个 颜色 相同 的 植物 ， 因 此 如 果 要 求 color 属 性 唯一 ， 这 将 严重 限制 未 来 的 
开发 。 作 为 一 个 可 行 的 方法 , 你 可 以 通过 在 数组 中 的 位 置 来 唯一 地 识别 每 个 植物 。 在 下 面 的 小 方 
中 ,我 们 将 介绍 一 个 新 的 jndex 值 ， 该 值 表示 一 个 植物 在 plants 数 组 中 的 位 置 ， 你 能 够 基于 它 
做 逆 映 射 。 


在 #each 循环 中 添加 数组 索引 信息 


在 写 这 本 书 的 时 候 ，{ {8@ingdex}} 辅 助 函 数 还 不 存在 "。 只 要 它 可 用 ,你 就 很 容易 访问 一 个 
植物 在 数组 中 的 位 置 ， 如 下 所 示 : 
<template name="plants"> 
{{#each plant in plants}} 
Index: {{@index}} 


Plant Color: {{color}} 
</template> 


在 新 的 辅助 函数 可 用 之 前 ， 你 需要 手动 实现 一 个 解决 方案 ， 以 在 each 块 内 部 获得 数组 元 素 
的 索引 。 

你 将 使 用 一 个 称 为 withInaex 的 全 局 辅助 函数 ， 它 会 返回 plants 数 组 ， 每 个 plLant 为 一 个 
对 象 ， 并 使 用 Underscore.js 提 供 的 map 函 数 为 每 个 对 象 增加 一 个 新 的 index 属 性 。“ 利 用 

























































































@ 该 功能 在 开发 分 支 已 经 可 用 了 ， 所 以 它 可 能 在 Meteor 1.2 和 以 后 的 版 本 中 可 用 。 
@@ Underscorejs 是 一 个 非常 有 用 的 库 ， 它 以 简单 的 方式 提供 了 常用 的 功能 。 更 多 内 容 可 参考 http:/underscorejs.org/。 
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Underscore.js， 你 可 将 代码 量 保持 在 最 小 。Underscore.js 是 Meteor 自 带 的 ， 不 需要 手动 来 添加 它 。 
代码 清单 53-6 显示 了 withIndex, 它 有 一 个 1ist 参 数 。 这 将 是 plants 数 组 。 首先, 它 检查 plant 
对 象 (v ) 是 否 等 于 nul1l1。 如 果 不 等 于 ， 就 为 这 个 对 象 添加 一 个 新 的 名 为 jndex 的 属性 ， 其 值 为 
当前 数组 的 位 置 (i )。 新 的 辅助 函数 需要 一 个 列表 参数 ， 它 返回 一 个 新 的 列表 ， 其 元 素 的 内 容 和 
顺序 与 输入 参数 完全 相同 ， 只 是 为 每 个 对 象 添加 了 一 个 额外 的 index 属 性 。 





















































代码 清单 5-6 ”利用 Underscore.js 为 对 象 数 组 添加 index 属 性 


Template.registerHelper('withIndex', function (list) { 


Var withIindex = _.map(list, function (v, i) { < 一 
if (v === null) return; 使 用 Underscore.js 
Vv.index = i; 的 map 子 数 来 遍历 
return v; 列表 

全 


return withIndex; 
上 
你 可 将 任何 数组 对 象 传递 给 withIndex 函 数 ， 然 后 在 模板 中 使 用 {{tindqex) } 在 循环 中 返回 
该 对 象 在 数组 中 的 位 置 。 这 样 一 来 ， 你 可 以 唯一 地 确定 #each 块 的 每 个 循环 及 其 创建 的 元 素 。 
在 houseForm 模 板 ， 调 整 #feach 块 标记 ， 将 植物 数组 传递 给 withInaex 函 数 ， 如 下 面 的 代码 清 
单 所 示 。 

















代码 清单 5-7 使 用 模板 辅助 函数 向 植物 添加 索引 


<template name="houseForm"> 


<form id="houseForm"> 





a 调整 这 行 代 码 , 其 
{{#each withIndex plants}} 余 的 保持 不 变 
{{> plantFieldset}} 
{{/each}} 
</form> 
</template> 





你 还 需要 修改 plantFieldset 模 板 , 为 每 个 字段 添加 index( 见 代 码 清 单 5-7 )。 另 外 需要 使 
用 属性 aata-inqex 来 存储 每 个 输入 ， 而 fieldset 本 身 将 使 用 ia 标识 。 

不 再 需要 像 前 面 那样 ， 做 一 个 基于 房屋 ID 和 植物 颜色 的 复合 ID ， 因 为 如 代码 清单 5-8 所 示 ， 
增强 模板 以 后 ， 可 以 通过 每 个 植物 在 当前 文档 plants 数 组 中 的 位 置 唯一 地 确定 它 。 现 在 可 以 有 
几 十 个 红色 的 植物 ， 它 们 共享 相同 的 名 称 ， 但 有 不 同 的 指示 "。 


























代码 清单 5-8 ”添加 索引 信息 到 plantFielgdset 模 板 


<template name="plantFieldset"> 
<fieldset> 

















@ 如 果 你 的 植物 学 知识 有 限 ， 让 植物 的 颜色 保持 唯一 或 至 少 添加 一 个 位 置 属性 可 能 确实 有 用 。 否 则 ， 你 不 应 该 以 专 
业 的 房屋 保姆 作为 职业 。 
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Color <input class="color" type="text" value="{{color}}" 


每 个 输入 元 data-index="{{index}}"> 
素 都 有 一 个 Instructions <input class="instructions" type="text" 
data-index value="{{instructions}}" data-index="{{index}}"> 
<button class="removePlant" data-index="{{index}}">Remove Plant</button> 
</fieldset> 
</template> 





这 时 候 ，showHouse 和 houseForm 模 板 都 将 显示 每 个 房屋 里 的 所 有 植物 。 现 在 让 我 们 更 进 
一 步 ， 实 现 拥 有 任意 数量 植物 的 房屋 的 编辑 。 


5.5 使 用 本 地 集合 进行 响应 式 更 新 


你 可 以 使 用 安全 网 络 来 编辑 文档 , 这 样 你 的 所 有 更 改 都 保持 在 本 地 的 浏览 器 中 。 不 像 其 他 的 
框架 ，Meteor 对 服务 器 上 或 本 地 的 数据 库 使 用 不 加 区 分 ， 所 以 你 可 以 使 用 在 前 一 章 学 到 的 关于 
CRUD 的 所 有 操作 。 但 这 一 次 , 你 不 会 使 用 它 将 数据 存储 回 服务 器 , 而 是 用 它 来 编辑 文档 的 内 容 ， 
直到 你 准备 好 将 它们 持久 化 到 中 央 数 据 库 。 

对 于 编辑 房屋 , 你 将 专注 于 两 个 模板 和 六 个 事件 , 每 个 模板 中 有 三 个 事件 。 这 仪 涉及 本 地 临 
时 集合 的 所 有 操作 。 图 5-5 概 述 了 哪个 模板 中 会 发 生 哪些 事件 。 












































Edit Stephan's house 
编辑 名 称 - 房屋 表单 
一 
Plants 
Color Red 
编辑 颜色 Instructions |3 pots/week | | Remove Plant 
编 名 指示 一 、| > Color we ] | 一 植物 字段 集 
:> Instructions |water daily | | Remove Plant | 
添加 植物 人 删除 植物 
NT 








i> Save House 





保存 房屋 








图 5-5 编辑 房屋 涉及 两 个 模板 和 六 个 事件 


让 我 们 看 看 代码 。 从 houseForm 模 板 的 事件 映射 开始 。 编 辑 文档 名 称 、 添 加 一 个 新 植物 、 保 
存 到 远程 数据 库 是 主要 的 函数 。 

因为 所 有 的 编辑 事件 都 会 触发 一 个 upaate () 操作 ， 所 以 可 以 通过 引入 一 个 通用 函数 来 执行 
LocalHouse 的 更 新 ， 以 减少 代码 的 行 数 。 正 如 你 知道 的 ， 集 合 的 每 个 upaate () 有 两 个 参数 : 
要 更 新 的 对 象 ( 文档 _iq 参 数 ) 以 及 如 何 更 新 它 (modifier 参 数 )。 让 我 们 使 用 代码 清单 5-9 来 保 
持 代 码 的 简洁 ， 将 这 些 代 码 放 在 clientjs 文 件 最 后 ， 你 不 必 再 碰 它 。 
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代码 清单 5-9 ”更 新 LocalHouse 集 合 的 封装 函数 
updateLocalHouse = function (id, modifier) { 
LocalHouse.updatel 
{ 
a 

} 

modifier 
); 

. 


虽然 _id 可 以 很 容易 地 从 session.get ("selectedHouseId") 中 获得 , 但 你 还 需要 一 些 代 
码 为 每 个 事件 构建 修改 器 (modifier )。 


5.5.1 houseForm 模板 的 事件 映射 


在 应 用 的 前 一 个 版 本 中 ,你 依靠 jQuery 获取 表单 值 ， 并 手动 把 它们 放 进 对 象 ， 然 后 存储 到 集 
合 中 。 这 个 时 候 你 可 以 减少 涉及 jQuery 的 代码 。 代 码 清单 5-10 显 示 了 如 何以 一 种 更 简单 的 方式 实 
现 相同 的 目标 。 


代码 清单 5-10 ”更 新 房屋 名 称 的 事件 映射 


Template.houseForm.evVents ({ 
'keyup input#house-name': function (evt) { 
evt .preventDefault (); 
Var modifier = {S$set: {'name': evt.currentTarget .value}}; 
updateLocalHouse (Session.get ('selectedHouseId'), modifier); 














/二 

有 

evt 对 象 可 以 让 你 访问 ID 为 house-name 的 输入 字段 的 内 容 。 每 当 有 按键 发 后 时 ， 你 把 name 
的 值 设 置 为 被 捕获 事件 currentTarget 属 性 的 value 值 ， 并 将 它 放 进 正确 的 Sset 语 法 中 ， 用 以 
更 新 MongoDB 集 合 。 然 后 你 使 用 当前 文档 ID 和 修改 器 来 调用 updaate () 函数 。 为 了 避免 浏览 器 重 
新 加 载 页 面 的 默认 行为 ， 必 须 保 留 svt .preventDefault () 指 令 。 

代码 清单 5-10 的 代码 完成 以 后 ，house-name 中 :input 元 素 值 的 每 个 变化 将 自动 更 新 页 面 上 
所 有 的 name 属 性 。 每 个 按键 会 触发 所 有 模板 以 新 的 name 值 进行 部 分 重 绘 。 模 板 的 其 余部 分 ， 如 
coloxr 或 instructions 字 段 ， 将 不 会 重 绘 。 

虽然 事件 和 按钮 相关 ， 但 类 似 的 代码 也 可 以 应 用 于 aqadaPlant 事 件 。 然 而 这 一 次 却 不 需要 
$set 语 法 。 但 因为 要 处 理 一 个 对 象 数 组 ， 所 以 需要 代码 清单 5-11 所 示 的 Spush 语 法 。 你 可 以 简单 
地 新 插入 一 个 空 的 植物 对 象 ， 以 color 和 instructions 作 为 它 的 属性 。 


代码 清单 5-11 添加 一 个 新 植物 的 事件 映射 
Template.houseForm.events({ 
'click button.addPlant': function (evt) { 
evt .preventDefault (); 
Var newPlant = {color: '', instructions: ''}; 
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var modifier = {Spush: {'plants': newPlant}}; 
updateLocalHouse (Session.get('selectedHouseId'), modifier); 


A 
县 


不 需要 以 任何 方式 来 操作 DOM， 简单 地 改变 底层 数据 就 将 更 新 模板 。 编 辑 name 属 性 ， 以 及 
单 击 按钮 添加 一 个 新 的 植物 ， 都 会 自动 更 新 屏幕 。 这 是 响应 式 数据 绑 定 在 起 作用 。 

在 继续 处 理 plantFieldaset 之 前 ， 让 我 们 来 看 看 第 三 个 事件 : 保存 到 远程 数据 库 (参见 代 
码 清单 5-12 )。 为 了 跟踪 最 后 一 次 保存 的 时 间 ， 每 个 房屋 都 有 个 lastsave 字 段 ， 它 保存 的 是 时 
间 戳 。 


代码 清单 5-12 保存 临时 文档 和 时 间 惟 到 数据 库 
Template.houseForm.events({ 

Ps 

'click putton#save-house': function (evt) { 
evt .preventDefault (); 
var id = Session.get('selectedHouseId'); 
var modifier = {S$set: {'lastsave': new Date()}}; 
updateLocalHouse (id, modifier); 
// persist house document in remote db 





























HousesCollection.upsert\( < 一 一 在 服务 器 上 保存 


LocalHouse.findOone (id) 
} 
4 
到 


说 明 因为 不 同 的 客户 有 不 同 的 时 钟 设置 ， 所 以 假设 客户 提供 的 时 间 惟 是 准确 的 不 是 个 好 的 做 
法 。 理想 情况 下 ， 用 于 数据 库 记录 的 时 间 惟 应 该 由 服务 器 创建 。 在 第 7 章 我 们 将 介绍 服务 
器 端的 方法 ， 这 将 使 你 能 够 轻松 地 实现 这 一 功能 。 











再 次 , 你 将 提供 一 个 修改 器 。 你 首先 更 新 本 地 的 房屋 文档 ,然后 将 其 发 送 到 远程 数据 库 。 但 
现在 你 遇 到 一 个 客户 端 运 行 代码 的 限制 : 如 果 你 成 功 地 更 新 本 地 文件 ， 但 服务 器 端 MongoDB 更 
新 失败 ,会 发 生 什 么 呢 ? 你 可 以 ( 可 能 也 应 该 ) 通过 检查 返回 值 和 捕获 异常 来 解决 这 个 问题 。 
次 ， 这 是 一 件 使 用 服务 器 端 方法 会 更 容易 完成 的 事情 ， 所 以 请 记 住 这 个 限制 。 第 7 章 将 给 你 必要 
的 工具 来 更 高 效 地 处 理 这 些 情况 。 

三 个 事件 已 经 实现 了 ,还 有 三 个 。 下 一 个 是 plantFieldset 模 板 。 
















































































5.5.2 plantFieldset 模板 的 事件 映射 


懒惰 是 程序 员 的 一 种 美德 ， 所 以 让 我 们 只 使 用 一 个 事件 来 改变 植物 的 color 或 instru- 
ctions 属 性 吧 。 这 样 ， 你 将 免费 获得 植物 所 有 可 用 属性 的 更 新 ， 比 如 说 ， 你 决定 添加 一 个 
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location 属 性 。 这 意味 着 你 必须 确定 要 插入 到 文档 中 的 值 ， 也 要 确定 属性 名 称 或 在 哪里 插入 。 
要 唯一 标识 一 个 属性 ， 你 需要 三 个 信息 : 
口 当前 植物 的 索引 ( 植物 在 plants 数 组 内 部 的 位 置 ， 比 如 0 ); 
口 当前 植物 的 属性 〈 文 档 中 的 字段 名 ， 如 颜色 一 一 color ); 
口 更 新 的 属性 值 (字段 的 值 ， 如 蓝 色 一 一 blue )。 
让 我 们 以 下 面 的 文档 为 例 : 
{ 
name: 'Manuel', 
plants: | 
{color: 'Red', instructions: '3 pots/week'}, 
{color: 'Yellow', instructions: 'keep humid'} 


] 
} 


要 把 第 一 个 植物 的 第 一 个 color 属 性 由 Red 改 为 Blue， 使 用 下 面 的 点 符号 : 

LocalHouse.update(id, {S$set: {"plants.0.color": "Blue"}}); 

正如 在 代码 清单 5-13 中 所 看 到 的 ， 首先 要 结合 必要 的 标识 符 来 访问 集合 中 正确 的 元 素 。 你 可 
以 从 HTML 元 素 的 Gata-index 属 性 中 获得 索引 ， 它 在 本 章 的 前 面 已 经 定义 过 。field 名 字 和 
input 元 素 的 class 属 性 相同 。 这 些 片段 通过 点 号 连接 ， 以 获取 当前 编辑 的 植物 和 属性 。 只 有 在 
使 用 中 括号 操作 符 时 , 才能 在 对 象 中 使 用 动态 连接 的 字段 名 或 使 用 变量 作为 键 , 这 就 是 为 什么 你 
必须 首先 使 用 字段 标识 符 来 设置 blantProperty， 然 后 再 使 用 中 括号 来 设置 新 的 值 ， 该 新 值 可 


通过 evt .CurrentTarget .value 来 访问 o 


代码 清单 5-13 ”更 新 植物 属性 的 事件 映射 


Template.plantFieldset.events({ 
'keyup input.color, keyup input.instructions': function (evt) { 
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evt .preventDefault (); 和 平常 
var index = evt.target.getAttribute('data-index'); 一 样 执 
var field = evt.target.getAttribute('class'); 行 更 新 
var plantProperty = 'plants.' + index + '.' + field; 一 
var modifier = {S$set: {}}; 

使 用 中 括号 i l 则 

< modqifier['Ssset'] [plantProperty] = evt.target.value; Ee 为 植物 和 

操作 符 设置 Ce 

新 的 值 updateLocalHouse (Session.get ('selectedHouseId'), modifier); 确切 的 ID 


} 
中 到 


MongoDB 让 你 可 以 在 集合 中 以 不 同方 式 操纵 数据 ， 但 不 幸 的 是 ， 没 有 一 个 简单 的 方法 能 从 
plants 数 组 中 删除 一 个 植物 对 象 "。 而 这 正 是 removePlant 按 钮 所 需要 做 的 。 要 绕 过 这 个 限制 ， 
首先 要 把 所 有 的 植物 放 在 一 个 数组 中 ， 然 后 拼接 ， 再 将 修改 后 的 plants 数 组 存储 到 文档 中 。 



































Q MongoDB 中 的 这 一 限制 为 “从 数组 中 删除 一 个 值 的 修改 器 ”( https://jira.mongodb.org/browse/server-1014 )， 其 历史 
可 追溯 到 2010 年 。 
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因为 你 在 plantFielaset 模 板 中 ， 所 以 当前 的 数据 上 下 文 仅 限于 一 个 植物 对 象 。 要 读 取 整 
个 plants 数 组 ， 可 以 在 本 地 集合 中 执行 另 一 个 查找 。 该 集合 在 浏览 器 内 ， 并 没有 网 络 延迟 会 影 
响 查 找 ， 所 以 可 以 使 用 以 下 方法 来 获得 当前 选 定 房屋 的 所 有 植物 : 
LocalHouse.findOne(Session.get('selectedHouseId')) .plants 

或 者 ， 可 以 使 用 全 局 的 Template 对 象 访问 上 一 级 数据 上 下 文 : 

Template.parentData(1) .plants; 

如 果 没 有 参数 ， 它 的 默认 值 为 1!1， 这 意味 着 上 一 级 数据 上 下 文 被 引用 。 你 可 以 根据 需要 添加 
到 多 层 ， 并 通过 将 其 名 称 添加 到 语句 中 来 访问 所 需要 的 数据 。 上 面 的 代码 相当 于 在 模板 内 使 用 
{{../plants}}o 

一 旦 以 JavaScript 数 组 的 形式 从 房屋 文档 中 获取 了 所 有 的 植物 ， 就 可 以 使 用 splice 来 提取 
HTML 按 钮 相关 索引 指定 位 置 的 元 素 。 这 将 得 到 删除 一 个 元 素 的 数组 ， 该 数组 将 用 于 moqifier。 
下 面 的 代码 清单 显示 了 用 于 删除 植物 的 事件 映射 。 


代码 清单 5-14 ”删除 植物 


Template.plantFieldset.events({ 





























'click putton.removePlant': function (evt) { 所 有 的 植物 都 
evt .preventDefault (); 放 入 一 个 数组 
var index = evt.target.getAttribute('data-index'); 
var plants = Template.parentData(1) .plants; < 一 可 以 使 用 splice 
plants.splice(index, 1); < 一 删除 一 个 数组 
var modifier = {Sset: {'plants': plants}}; 元 素 
updateLocalHouse (Session.get('selectedHouseId'), modifier); 

9 

Ee 


}) 

这 些 是 对 现 有 房屋 进行 完整 编辑 需要 的 所 有 事件 。 它 们 和 selectHouse 事 件 中 提供 的 代码 
一 起 ， 构 成 了 一 个 足够 灵活 的 方法 ,也 可 用 于 创建 新 房屋 ， 这 时 你 只 需 从 下 拉 菜 单 中 选择 “ 空 选 
项 ”就 可 以 了 。 


























说 明 我 们 还 没有 详细 讨论 ， 但 删除 一 个 房屋 时 ， 请 确保 把 它 从 Housescollection 和 Local- 
House 中 都 删除 了 。 在 讨论 下 一 个 部 分 之 前 ， 先 做 这 个 简单 的 修复 。 


该 应 用 在 可 用 性 方面 仍然 缺乏 一 点 东西 。 当 你 刚 接 了 一 个 宛 长 的 电话 后 , 你 如 何 判断 浏览 
上 的 文件 是 否 已 经 被 你 修改 过 ? 更 糟 的 是 ,如 果 一 个 同事 修改 了 你 正在 编辑 的 同一 个 房屋 , 并 且 
保存 了 修改 ， 而 你 却 不 知道 ， 这 将 会 发 生 什么 ? 你 可 以 用 一 个 基本 的 通知 系统 "来 大 大 改进 这 个 
应 用 ， 这 个 系统 将 在 数据 库 内 容 有 更 新 时 ， 提 供 和 保存 一 些 提醒 和 和 警告 。 





















































@ 当 我 们 在 第 9 章 谈论 包 的 时 候 ， 你 会 看 到 一 个 实现 通知 系统 的 更 有 效 的 方法 。 
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5.6 ”实现 一 个 简单 的 通知 系统 


人 允许 多 个 用 户 同时 编辑 相同 数据 的 任何 应 用 都 必须 处 理 并 发 的 存储 。 如果 你 开始 编辑 一 个 房 
屋 ， 当 你 还 在 编辑 的 时 候 ， 有 人 进行 了 更 新 ， 这 时 会 发 生 什么 呢 ? 让 我 们 假设 Manuel 和 Stephan 
都 在 编辑 相同 的 房屋 文档 ， 如 图 5-6 所 示 。Stephan 在 他 的 家 里 更 新 了 植物 , 文档 包含 了 三 种 植物 : 
红色 、 橙 色 、 白 色 。 当 他 完成 后 ， 他 将 更 改 保存 到 服务 器 上 。 同 时 ，Manuel 已 经 开始 编辑 Stephan 
辑 过 的 房屋 。 他 只 看 到 一 个 本 地 副本 ， 只 有 两 种 植物 : 红色 和 蓝 色 。 数 据 库 内 容 已 经 发 生 了 变 
化 , 那么 Manuel 的 视图 应 该 发 生 一 些 什么 变化 呢 ? 一 种 可 能 是 , 丢弃 所 有 的 本 地 修改 , 使 用 文档 
的 最 新 状态 响应 式 更 新 视图 。 自 动 这 样 做 不 是 一 个 理想 的 解决 方案 , 其 结果 是 用 户 体验 差 ; 这 可 
能 会 使 Manuel 很 泪 素 ， 因 为 他 会 觉得 他 丢失 了 重要 的 数据 。 也 许 他 的 数据 比 Stephan 的 更 新 。 


Fr 显示 Stephan 房 
屋 的 本 地 版 本 @ 


应 用 编辑 Stephan 的 房屋 /AN 
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图 $-6 ”处 理 同一 所 房屋 的 并 发 编辑 

许多 情况 下 要 避免 即时 更 新 ， 比如， 考虑 一 个 简单 的 方法 来 提供 反馈 以 取消 编辑 ,或 者 为 保 
持 一 定 程度 的 一 致 性 ,文档 只 能 被 完整 地 修改 时 。 

无 论 哪 种 方式 ， 如 果 没 有 方法 在 同一 时 间 协 同 更 新 文档 , 并 且 直 接合 并 更 新 到 文档 , 那么 更 
好 的 方法 是 使 用 通知 消息 来 说 明 Manuel 打 开 的 本 地 副本 已 经 过 时 了 。 

除了 要 有 一 个 区 域 来 显示 通知 外 , 你 还 需要 一 个 触发 需 来 确定 什么 时 候 显示 消息 以 及 显示 什 
么 消息 ， 因 此 你 需要 扩展 本 地 文档 的 update () 操 作 ， 用 status 属 性 来 显示 文档 是 否 已 被 修改 。 
同时 还 要 避免 覆盖 别人 的 修改 。 为 此 ， 你 要 实现 一 个 通知 ， 当 远程 数据 被 其 他 人 更 改 时 会 出 现 。 
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有 许多 方法 来 实现 它 ， 在 这 一 章 ， 你 将 依靠 1astsave 属 性 来 确定 当前 正在 编辑 的 文档 是 否 已 经 
被 其 他 人 修改 过 。 

通知 的 第 二 个 用 例 是 为 了 防止 用 户 不 小 心 丢 弃 已 编辑 的 文档 。 所 以 你 也 会 建立 下 拉 列 表 的 安 
全 网 ， 不 会 让 用 户 在 当前 页 面 有 未 保存 的 修改 时 切换 房屋 。 


5.6.1 添加 通知 模板 


所 有 通知 将 显示 在 页 面 的 顶部 。 如 果 没 有 要 显示 的 消息 或 警告 , 通知 区 域 将 不 可 见 。show- 
House 和 formHouse 模 板 已 经 使 用 了 类 似 的 方法 ， 如 果 没 有 数据 上 下 文 ， 它 们 将 不 会 被 演 染 。 
你 将 使 用 一 个 额外 的 模板 notificationArea 来 检查 是 否 存 在 一 个 notification 对 象 。 如 
果 有 的 话 , 将 使 用 它 的 样式 和 文本 属性 向 用 户 显 示 一 个 消息 ,下面 的 代码 清单 显示 了 模板 的 代码 。 


代码 清单 5-15 ”使 用 模板 来 显示 通知 
<template name="notificationArea"> 
{{#if notification}} 
<p class="{{notification.type}}">{{notification.text}}</p> 
( 涉 让 直 让 让 
</template> 


你 可 以 通过 使 用 { {> notificationArea}} 在 你 喜欢 的 地 方 答 入 这 个 模板 ， 比 如 在 表单 模 
板 中 或 在 页 面 的 顶部 。 


5.6.2 ”添加 状态 属性 


引入 一 个 新 的 status 属 性 ， 这 是 跟踪 房屋 文档 状态 的 最 好 方法 。 它 有 以 下 三 个 状态 。 

口 HouseCollection 和 LocalHouse 中 某 个 文档 的 内 容 相 同 。 这 不 需要 通知 。 如 果 用 户 只 

看 内 容 ， 不 使 用 表单 进行 任何 更 新 ， 就 没有 必要 显示 实际 文档 内 容 以 外 的 任何 通知 。 

口 LocalHouse 具 有 本 地 的 或 没有 保存 的 更 新 ， 但 远程 文档 没有 改变 。 如 果 只 有 本 地 编辑 ， 

必须 显示 警告 ， 说 明 当 前 页 面 有 未 保存 的 更 改 ， 离 开 当 前 页 面 会 丢掉 数据 。 

口 当 你 在 编辑 当前 文档 时 ， 远 程 文档 已 经 更 新 了 。 在 这 种 情况 下 ， 远 程 数据 库 包 含 较 新 的 
内 容 ， 而 不 是 用 户 当 前 在 浏览 器 中 看 到 的 内 容 。 警 告 信息 必须 告诉 有 用户， 现在 保存 将 覆 
盖 服 务 器 上 的 一 个 新 版 本 。 

当 用 户 选 择 一 个 新 房屋 时 ,第 一 个 状态 是 初始 状态 。 它 不 需要 任何 额外 的 代码 ,我 们 来 看 第 

二 种 情况 : 识别 未 保存 的 更 改 。 

要 添加 状态 ， 你 将 扩展 已 经 用 于 LocalHouse .update() 操 作 的 修改 器 。 在 大 多 数 情况 下 ， 

给 $set 语 句 添 加 一 个 新 的 键 值 对 就 是 够 了 。 添加 植物 使 用 $spush 运 算 符 , 所 以 你 必须 为 修改 器 添 

加 一 个 专用 $set 语 句 。 对 于 color 和 instructions 事 件 , 你 还 将 使 用 中 括号 向 更 新 修改 器 添加 

状态 。 保 存 按钮 将 状态 设置 为 saved， 所 以 要 确保 设置 正确 的 状态 。 下 面 的 代码 清单 显示 了 在 事 

件 映射 中 必须 存在 的 代码 。 
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代码 清单 5-16 ”在 更 新 修改 顺 中 话 加 状态 


Template.houseForm.events({ 
'click button#save-house': function (evt) { 


Ves 
Var modifier = {$set: {'lastsave': new Date(), 'status': 'saved'}}; 
Save 按 钮 | }， 
设置 status "上 Click button.addPlant': function (evt) { 
为 saved VD BA | 
Var modifier = {S$push: {'plants': newPlant}, S$set: {'status': 
'unsaved'}}; < $push 和 $set 
)， 可 以 在 一 个 操 
'keyup input#house-name': function (evt) { 作 中 完成 
AR 
Var modifier = {$set: {'name': evt.target.value, 'status': 'unsavedq' 


3 


Template.plantFieldset.events({ 
'click button.removePlant': function (evt) { 
fa 
Var modifier = {$set: {'plants': plants, 'status': 'unsaved'}}; 
} 
'keyup input.color, keyup input.instructions': function (evt) { 
Ws 
modifier['$set'] .status = 'unsaved'; < 一 使 用 中 括号 运算 符 


添加 状态 字段 


表单 内 容 的 每 个 更 改 将 不 仅 触发 一 个 LocalHouse 的 更 新 ， 它 也 将 设置 status 属 性 为 
unsaved。 单 击 Save 按 钮 或 选择 另 一 个 房屋 应 该 重 置 当前 状态 。 


5.6.3 ”使 用 会 话 变 量 触发 通知 


可 以 很 容易 使 用 一 个 辅助 函数 来 确定 不 同 的 状态 并 返回 实际 显示 的 文本 和 样式 , 但 在 这 一 章 
中 ,你 将 使 用 一 个 专用 的 session 变 量 来 触发 消息 。 保 持 代码 分 离 将 使 未 来 扩展 代码 更 简单 ， 因 
为 只 需要 更 新 一 个 位 置 。 代 码 清单 5-17 中 的 代码 现在 应 该 看 起 来 很 熟悉 ， 它 是 一 个 简单 的 辅助 函 
数 ， 返 回 session 变 量 notification 的 内 容 。 
代码 清单 5-17 基于 会 话 变 量 显示 通知 的 辅助 函数 

Template.notificationArea.helpers(t{ 

notification: function () { 
return Session.get ('notification'); 
} 

} 

Session 变 量 的 内 容 必 须 基 于 简单 的 条 件 变 量 进行 设置 。 不 需要 介入 到 更 新 修改 器 ,你 可 以 
使 用 一 个 计算 来 检查 某 些 条 件 。 如 果 这 些 条 件 都 满足 ， 它 会 响应 式 地 设置 正确 的 通知 内 容 。 

早 些 时 候 ， 你 用 Tracker.autorun 建 立 过 一 个 响应 式 计算 。 这 一 次 你 可 以 把 它 限 制 在 
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houseForm 模 板 ， 因 为 这 是 唯一 一 个 可 能 触发 状态 更 新 的 地 方 。 在 模板 上 下 文中 使 用 autorun 
的 优势 是 ， 一 旦 模板 被 销毁 ， autorun 困 数 也 会 被 销毁 。 我 们 在 第 4 章 讨 论 了 createq 回 调 函 数 
的 钧 子 : 

















Template.houseForm.onCreated(function () { 
this.autorun(function () { 
// do stuff 


}) 
9 字 


autorun 中 ， 你 将 检查 两 个 条 件 。 

口 一 个 房屋 文档 是 否 被 选择 ， 它 的 status 是 不 是 等 于 unsaved? 若是 ， 就 设置 通知 消息 为 

一 个 保存 提醒 。 

口 远程 文档 的 lastsave 时 间 截 是 否 比 本 地 临时 文档 新 ?” 若是 ， 就 将 通知 信息 设置 为 警告 。 
如 果 这 些 条 件 都 没有 被 满足 ， 那 就 不 会 有 任何 通知 ， 你 可 以 安全 地 进行 工作 。 代 码 清 单 5-18 

说 明了 如 何在 clientjs 中 进行 检查 。 因 为 Session 对象 可 以 保存 整个 对 象 ， 所 以 你 可 以 通过 

Session.set() 同 时 存储 通知 的 Lype 以 及 text 属 性 。 


代码 清单 5-18 在 autorun 中 设置 通知 






































Template.houseForm.onCreated(function () { 
this.autorun(function () { 
if (HousesCollection.findone(Session.get('selectedqHouseId' ) ) && 
LocalHouse.findOne(Session.get('selectedHouseId')).lastsave < 
检查 文档 是 HousesCollection.findOne(Session.get('selectedHouseId')).lastsave) { 
Ee 年 Session.set('notification', { 
否 已 经 在 服 type: 'warning', 
务 器 上 , 是 不 text: 'This document has been changed inside the database!' 
是 更 新 }); 
} else if (LocalHouse.findOone(Session.get('selectedHouse1Id')) && 
LocalHouse.findOne(Session.get('selectedHouseId')).status === 'unsaved') {<— 


Session.set('notification', { 
type: 'reminder', 
text: 'Remember to save your changes' 


的) 汉 检查 本 地 文 
} else { 档 是 否 有 未 
Session.set('notification', ''); 保存 的 状态 


}) 
} 


打开 两 个 浏览 器 ,检查 代码 是 否 按 预期 工作 ( 参见 图 5-7 )。 如 果 在 两 个 浏览 器 中 打开 同一 个 
房屋 并 开始 编辑 ， 你 会 看 到 一 个 绿色 "的 消息 文本 ， 它 告诉 你 记得 保存 你 的 修改 。 当 你 一 旦 在 一 
个 浏览 器 中 保存 修改 ， 另 一 个 浏览 器 会 在 红色 背景 上 告诉 你 ， 数 据 库 中 的 该 文档 已 被 修改 了 。 















































@ 当然， 如果 你 把 本 章 代 码 中 的 CSS 类 放 进 你 的 styles.css 文 件 ， 消 息 才 会 是 绿色 的 。 








浏览 器 1 仍然 显示 
一 个 过 时 的 文档 


















四 ® ， 四 mehousesmer x 全 


[ea || 
7 Ee soe io ent oo 


The House-Sitter App 
Stephan 1:] 
Taking care of Stephan's | Edit Stephan's house 


house Ee 
Name |Stephan 














The House-Sitter App 





Edit Stephan's house 
































ee? Last visit: Tue Jun 23 2014 08:43:04 ER 
Last visit: Tue Jun 23 2015 08:44:04 GMT+0200 (CEST) Name [Stephan 
Plant color: Red Plants 
Instructions: 3 pots/we 
Instructions: water daily | Done 
Delete this house 
N= / 
Sg 本 
浏览 器 1 正在 编辑 ， 本 








存 到 HousesCollection 
图 5-7 远程 更 改 将 触发 一 个 警告 消息 ， 提 醒 内 容 已 被 修改 


现在 你 可 以 对 这 个 相当 简单 的 解决 方案 作出 改进 。 可 能 的 改进 包括 分 列 显示 远程 和 本 地 文 
档 ， 以 便 用 户 很 容易 看 到 差异 。 而 这 只 需要 在 showHouse 模 板 中 显示 Housescollection 的 内 
容 ， 并 在 houseForm 中 显示 LocalHouse 的 数据 。 你 其 至 可 以 高 亮 显示 不 同 的 字段 ， 以 给 出 更 多 
的 指导 。 我 们 已 经 介绍 了 足够 的 基础 知识 ， 现 在 你 应 该 能 够 自己 改进 这 个 应 用 了 。 

如 果 想 包含 谁 改变 了 文档 的 信息 ， 你 必须 首先 了 解 用 户 的 概念 以 及 Meteor 如 何 处 理 它 们 。 在 
下 一 章 将 学 习 如 何 处 理 用 户 和 认证 ， 并 学 习 如 何 限制 用 户 只 能 编辑 某 些 字段 或 文档 。 















































5.7 ”总结 


在 这 一 章 中 ， 你 学 到 了 以 下 内 容 。 

口 本 地 集合 是 不 同步 的 ， 可 以 像 普通 的 数据 库 那 样 使 用 ， 即 使 它们 只 存在 于 浏览 器 的 内 存 
中 。 这 意味 着 它们 不 受 网 络 延迟 或 磁盘 性 能 的 影响 。 

口 使 用 集合 和 模板 之 间 的 响应 式 数据 绑 定 后 ， 不 需要 手动 更 新 DOM。 简 单 地 更 新 数据 源 会 
触发 视图 更 新 。 

口 响应 式 数据 绑 定 与 其 他 框架 中 的 双向 数据 绑 定 具有 类 似 的 效果 。 

口 Blaze 模 板 不 能 返回 数组 索引 位 置 ， 需 要 一 个 辅助 也 数 。 

口 Session 可 以 用 来 实现 一 个 简单 的 通知 系统 。 
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本 章 内 容 

口 让 用 户 可 以 通过 用 户 名 /密码 进行 注册 
口 连接 到 SMTP 服 务 器 发 送 电子 邮件 

口 定制 账户 相关 的 电子 邮件 消息 

口 通过 Facebook 添 加 OAuth 认 证 

口 使 用 allow/deny 来 管理 权限 











一 旦 应 用 被 连接 到 一 个 或 多 个 数据 源 , 它 就 可 以 显示 动态 的 内 容 。 要 为 不 同 用 户 定义 个 性 化 
的 内 容 , 应 用 需要 知道 是 谁 在 请 求 数据 。 最 可 能 的 情况 是 一 些 用 户 能 够 添加 内 容 , 但 会 有 些 限制 ， 
比如 什么 数据 可 以 访问 以 及 可 以 用 它 来 做 什么 。 

因为 这 些 原因 ， 本章 将 介绍 用 户 和 账户 的 概念 。 到 现在 为 止 , 我 们 一 直 保 持 着 相当 简单 的 开 
发 方式 ， 即 假定 只 有 一 种 类 型 的 用 户 : 匿名 用 户 。 除 非 应 用 可 以 识别 某 个 用 户 为 特定 用 户 ， 否 则 
我 们 不 能 为 用 户 显示 特定 的 内 容 。 

确定 一 个 用 户 的 过 程 称 为 认证 ( authentication )。 在 这 一 章 中 我 们 将 讨论 如 何 让 用 户 在 应 用 中 
注册 ， 如 何 使 用 用 户 名 和 密码 组 合 来 识别 用 户 ， 以 及 如 何 通过 使 用 现 有 的 服务 ( 如 Facebook、 
Twitter 或 GitHub ) 来 验证 用 户 并 进行 登录 。 

账户 相关 的 第 二 个 主要 概念 是 授权 (authorization )， 它 将 为 每 个 应 用 引入 安全 的 基础 。 其 最 
简单 的 形式 是 : 登录 用 户 和 匿名 用 户 可 能 会 被 区 别 对 待 。 通 常 ， 应 用 需要 更 细 粒 度 的 方式 来 定义 
权限 ， 因 此 会 员 及 管理 员 等 角色 将 成 为 重要 的 概念 。 

本 章 你 将 学 习 如 何在 应 用 中 添加 用 户 ， 其 方法 是 使 用 Meteor 核 心 功能 中 的 密码 认证 和 
OAuth。 从 注册 、 编 辑 用 户 个 人 信息 到 删除 账户 ， 每 一 步 都 将 会 讨论 。 你 将 会 利用 在 第 4 章 所 学 
到 的 知识 ,使 用 collection 人 允许 用 户 交 换 消息 ,并 为 删除 和 查看 消息 等 细 粒 度 的 操作 设置 权限 。 

为 了 探索 用 户 相 关 的 功能 ， 你 将 再 构建 一 个 小 应 用 。Meteor 不 需要 特定 的 文件 结构 。 在 本 章 
中 ， 你 将 使 用 图 6-1 所 示 的 结构 。 
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模板 、 样 式 、 应 用 代码 (客户 端 ) 
v 国 client EC 
人 client.js 
@ styles.css 
由 templates.html 


v BM collections 0 
盟 collections.js 数据 源 定义 (客户 端 和 服务 器 端 ) 


v BM common ee 
共享 代码 (客户 端 和 服务 器 端 ) 


坑 | common.js 


| i 
© 应 用 代码 (服务 器 端 


server.js 



































图 6-1 ”userApp 应 用 的 结构 


首先 创建 一 个 新 的 项 目 ， 然 后 如 图 6-1 那 样 设置 文 件 和 文件 夹 。 设 置 好 以 后 ， 我 们 将 从 用 户 
处 理 中 的 身份 认证 开始 。 


6.1 将 用 户 加 入 应 用 




















我 们 的 应 用 应 该 能 够 知道 谁 正在 使 用 它 。 这 将 是 以 后 可 以 授予 、 限 制 访问 及 功能 的 基础 。 幸 6 











运 的 是 ，Meteor 可 以 很 容易 地 实现 添加 用 户 功能 ， 几 乎 不 需要 任何 代码 。 

在 Web 上 添加 用 户 最 常见 的 情况 是 为 了 让 访客 注册 。 这 将 使 他 们 从 客人 变 成 用 户 。 你 将 使 用 
电子 邮件 地 址 或 用 户 名 作为 标识 符 ， 并 通过 密码 验证 用 户 。 

用 户 管理 的 基本 工作 流程 如 下 : 

(1) 用 户 注册 ; 

(2) 用 户 登 录 ; 

(3) 重 置 用 户 密码 。 











6.1.1 添加 密码 认证 


并 不 是 每 个 应 用 都 需要 账户 ， 所 以 账户 功能 在 新 建 的 项 目 中 是 不 可 用 的 。 然 而 这 个 功能 是 
Meteor 核 心包 的 一 部 分 ， 可 以 使 用 CLI 工 具 来 快速 地 添加 它 。 下 面 的 命令 将 扩展 现 有 的 应 用 ， 允 
许 用 户 注册 、 登 录 并 执行 基本 用 户 工 作 流 程 中 的 所 有 相关 操作 : 


$ meteor add accounts-password 
$ meteor add accounts-ui 


第 一 个 命令 添加 了 使 用 密码 的 功能 。 第 二 个 命令 增加 了 用 户 操作 (注册 /登录 /密码 重 置 ) 模 
板 和 相关 的 样式 信息 。 如 果 你 希望 在 模板 中 使 用 自己 的 样式 ， 不 希望 应 用 默认 的 样式 ， 可 添加 
accounts-ui-unstyledo 


这 两 个 命令 将 确保 所 有 的 依赖 关系 都 会 得 到 满足 。 例如 ;SCCOUNES=PAas sword 包 使 用 户 可 
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以 重 置 密 码 。 要 进行 密码 重 置 ， 需 要 email 模 块 来 将 密码 重 置 链接 发 送 给 用 户 ， 因 此 这 个 模块 也 
会 被 添加 到 应 用 中 。 另 外 ， 使 用 默认 的 登录 界面 风格 时 需要 LESS 的 预 处 理 ， 所 以 less 包 也 会 被 
添加 。Meteor 将 在 命令 行 上 显示 哪些 包 被 添加 的 详细 信息 。 在 项 目 文件 夹 下 的 .metero/package 文 
件 中 可 以 找到 所 有 包 的 信息 。 

添加 这 些 包 以 后 ， 再 次 启动 Meteor 服 务 器 。 

添 赤 加 用 户 模板 

现在 在 client/templates.html 文 件 中 可 以 添加 用 户 相 关 的 子 模板 。accounts-ui 包 中 包括 所 
有 需要 的 模板 ， 你 只 需要 在 现 有 模板 中 的 某 个 位 置 添 加 一 个 包含 标签 ， 如 代码 清单 6-1 所 示 。 
































说 明 本 章 的 代码 中 ， 我 们 使 用 neteor aqd twbs:bootstrap 添 加 了 Bootstrap 3 以 提供 更 好 的 
外 观 和 感觉 。 我 们 没有 使 用 默认 的 accounts-ui 包 ， 而 是 使 用 了 ian:accounts-ui- 
bootstrap-3 包 ,， 它 可 以 很 好 地 和 Bootstrap 3 集成 在 一 起 。 


代码 清单 6-1 添加 登录 按钮 ( loginButtons ) 


<head> 
<title>Working with users</title> 
</head> 
<body> 
<div class="container"> 、 
<div class="navbar"> 这 包含 了 实际 
{{>loginButtons }} 一 的 用 户 模板 
</div> 
<hil>Working with users</h1l> 
</div> 
</body> 














图 6-2 显 示 了 如 何 将 登录 功能 呈现 给 用 户 。1oginButtons 模 板 创 建 了 一 个 可 扩展 的 框架 ， 
它 在 单个 容器 中 提供 了 登录 、 注 册 和 密码 重 置 功 能 。 当 用 户 单 击 Sign In( 登录 ) 时 ,会 打开 对 话 
框 ， 其 中 提供 了 三 个 按钮 。 默 认 情 况 下 ， 用 户 通 过 电子 邮件 地 址 和 密码 来 识别 确定 。 使 用 
Accounts.ui.config 可 配置 是 否 需 要 用 户 名 ,或 者 可 以 使 电子 邮件 地 址 为 可 选项 目 。 

在 我 们 改变 默认 行为 之 前 ， 先 使 用 登录 框 注册 第 一 个 用 户 。 
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忌 击 登 习 
打开 登录 框 
ee@ee / EYWworking with users x 加 | 
所 > © | 口 ocalhost'3000 v mw 三 
UserApp Home Sign in / Join ~ 
现 有 用 户 
. Usemame or Email 登录 
Working with users | 
Password 
Please log in. | 
Forgot password? Create account 
密码 重 置 注册 新 用 户 
图 6-2 ”登录 框 








6.1.2 ”注册 和 密码 重 置 


理想 情况 下 , 应 用 的 注册 过 程 应 尽 可 能 简单 和 快速 。 这 会 鼓励 用 户 注册 ,如 果 其 中 涉及 多 个 
步 又 ， 则 用 户 可 能 会 取消 注册 过 程 。 因 此 ，Meteor 默 认 的 用 户 注 册 过 程 只 需要 最 少 的 用 户 信息 。 
一 且 用 户 注册 成 功 ， 你 可 以 提醒 他 们 填写 个 人 信息 或 回答 更 多 的 问题 。 

注册 用 户 最 简单 的 方法 是 要 求 提 供 他 们 的 电子 邮件 地 址 和 密码 。 这 两 个 部 分 已 足够 唯一 地 识 
别 用 户 ， 并 在 一 定 程 度 上 保护 他 们 账户 的 安全 。accounts-password 包 要 求 所 有 的 密码 至 少 有 
六 个 字符 长 。 

使 用 登录 框 ， 填 写 这 两 个 信息 ， 注 册 你 的 第 一 个 用 户 。 然 后 点 击 登录 按钮 下 面 的 创建 账户 
(Create account ) 链接 。 注 意 现 在 那个 大 的 登录 按钮 也 将 显示 为 Create Account ( 图 6-3 )。 就 这 样 ， 
你 注册 了 应 用 的 第 一 个 用 户 。 
































stephan@meteorinaction.com 


Cancel 











图 6-3 ”使 用 登录 框 创建 账户 
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1. 用 户 集合 











开 Robomongo 或 在 另 一 个 终端 中 使 用 meteor mongo 来 访问 数据 | 
询 users 集 合 的 内 容 : 





EE 





广 o 


用 户 是 应 用 的 长 期 存储 ， 所 以 存储 在 数据 库 集 合 中 。 使 用 meteor run 启 动 Meteor 服 务 ， 打 
| 


在 数据 库 shell 中 ， 像 这 样 查 
qb.users.final() : 








警告 有 数据 库 用 户 和 应 用 用 户 之 分 。 应 用 用 户 存 储 在 一 个 真实 的 Collection 中 ,而 不 是 你 在 
Robomongo 中 看 到 的 特殊 用 户 文件 夹 中 。 数 据 库 用 户 需要 在 连接 Meteor 和 MongoDB 时 使 
用 ,通常 这 种 类 型 的 用 户 只 需要 一 个 。 


现在 当 查 看 一 个 用 户 文档 时 ( 参见 代码 清单 6-2 )， 它 包含 四 个 顶级 字段 。 
DD _ig 
































保存 每 个 用 户 唯 一 的 数据 库 ID ， 也 可 以 通过 Meteor .userId() 来 访问 。 
口 createdqAt 一 一 用 户 在 应 用 中 创建 /注册 的 时 间 戳 。 
口 emails 








与 用 户 关 联 的 一 个 或 多 个 地 址 的 数组 。 每 个 电子 邮件 地 址 只 属于 一 个 用 户 ， 
可 以 是 验证 过 的 或 没有 验证 过 的 。 
口 servers 





"_igd" : "xcwYNyvMhP8rq6EPp", 

"createdAt" TSODate 人 (2015=05=227T123 4 33282127 小 7 
"emails" : [ 

{ 


"address" 


一 个 对 象 , 包含 特定 登录 服务 所 使 用 的 数据 , 如 忘记 密码 链接 时 使 用 的 令 牌 。 
代码 清单 6-2 存储 在 用 户 集合 中 的 单个 用 户 文档 
{ 


"stephan@meteorinaction.com", 
"verified" : false 
} 


] ， 


"services" : { 
"password" : { 


"Porypt"" 和 
} 


"$2a$l10$SOsFJKxSApp68T9el1fjKvtXBAdBP.. .SnY 
"resume" : { 
"JoginTokens" : [ 
{ 
"when" 


ISODate("2014-12-26T09:24:51.3822") ， 
"hashedqToken" : "SAMZRZMnaWrmXbmocm7cDPKzG5JR5daf. ..8f9bUTo=" 
小 
] 
} 
} 


} 


对 于 每 个 身份 验证 提供 








程序 ，services 字 段 保 存 执行 身份 验证 所 需 的 信息 。 默 认 情 况 下 ， 
密码 存储 时 使 用 bcrypt 加 密 算法 ， 这 也 是 BSD 和 许多 Linux 系 统 中 使 用 的 密码 哈 希 算 法 。 
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存储 在 用 户 文档 中 的 字段 没有 任何 限制 ， 所 以 你 可 以 用 自己 喜欢 的 方式 扩展 它 。 还 有 另外 
两 个 标准 的 字段 ， 可 以 在 需要 时 填写 : username 和 profile。 因 为 注册 过 程 不 需要 用 户 设 置 
username, 所 以 你 不 会 在 这 个 例子 中 使 用 这 个 字段 。profile 字 段 包含 一 个 对 象 , 默认 情况 下 ， 
关联 用 户 对 该 对 象 有 完全 的 读 取 和 写 人 权限 。 这 个 对 象 是 存储 真实 名 字 、 简 历 文 本 或 电话 号 码 
等 的 默认 地 方 。 

为 了 让 用 户 分 享 社会 信息 以 及 保护 他 们 的 身份 , 你 需要 用 户 提供 用 户 名 并 确保 所 有 的 用 户 都 
有 个 人 信息 ， 他 们 可 以 用 喜欢 的 方式 来 填写 个 人 信息 。 

2. 配置 注册 过 程 

登录 框 仅 在 客户 端 上 可 用 ， 因 此 相应 的 配置 也 需要 在 客户 端 上 下 文中 进行 。 通 过 调整 
Accounts .ui.config 对 象 的 passwordsignupFieldq 设 置 ， 你 可 以 要 求 用 户 在 注册 过 程 中 提供 
用 户 名 。 正 如 表 6-1 所 示 ， 每 个 设置 有 不 同 的 要 求 ， 其 中 列 出 了 注册 过 程 中 必须 提供 的 字段 。 


表 6-1 passwordsignupFields 的 可 能 值 


















































设 置 用 户 名 电子 邮件 
USERNAME_AND_EMAIL 强制 性 的 强制 性 的 
USERNAME_AND_OPTIONAL_ EMAIL 强制 性 的 可 选择 的 
USERNAME_ONLY 强制 性 的 N/A 
EMAIL_ONLY N/A 强制 性 的 











在 本 章 中 , 我 们 将 假设 每 个 用 户 都 有 一 个 用 户 名 。 电 子 邮 件 地 址 对 我 们 来 说 并 不 重要 ,如果 
用 户 不 希望 有 重 置 密码 的 功能 ， 我 们 不 会 强制 要 求 用 户 提供 一 个 地 址 。 代 码 清单 6-3 显 示 了 如 何 
配置 应 用 ,使 其 在 注册 过 程 中 要 求 提供 用 户 名 和 一 个 ( 可 选 ) 电子 邮件 地 址 。 


代码 清单 6-3 ”配置 注册 过 程 ， 要 求 提 供用 户 名 和 电子 邮件 
Accounts.ui.config(t{ 

passwordSignupFields: 'USERNAME_AND_ OPTIONAL EMAIL' 

a 


请 记 住 , 这 个 配置 代码 位 于 某 个 不 在 服务 器 上 执行 的 文件 中 , 或 者 至 少 是 包 在 一 个 Meteor. 
isclient 块 中 。 如 果 不 这 样 做 ， 应 用 将 产生 错误 。 我 们 把 它 放 在 client/clientjs 中 。 

当 配 置 完成 时 ,创建 一 个 新 账户 的 登录 框 将 显示 四 个 字段 ， 而 不 是 两 个 ， 如 图 6-4 所 示 。 
因为 用 户 可 能 决定 不 提供 电子 邮件 地 址 ， 这 样 他 们 将 无 法 重 置 密码 ， 所 以 确保 他 们 输入 正确 的 
密码 很 重要 。 基 于 这 个 原因 ， 这 里 有 一 个 密码 验证 字段 ， 这 个 字段 在 强制 使 用 电子 邮件 地 址 时 
不 会 显示 。 

如 果 现 在 注册 新 用 户 时 不 使 用 电子 邮件 地 址 ， 你 会 发 现 MongoDB 集 合 里 面 没 有 emails 字 
段 。 这 是 因为 空 字段 不 会 在 NoSQL 数 据 库 中 创建 。 这 不 同 于 MySQL 这 样 的 关系 数据 库 中 使 用 的 
国定 模式 表格 。 新 的 字段 可 以 在 任何 时 候 添 加 ， 因 此 不 需要 在 文档 中 存储 空 的 字段 。 
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stephan 


stephan@meteorinaction.com 








Cancel 





























图 6-4 ”创建 账户 时 ， 强 制 使 用 户 名 而 电子 邮件 地 址 可 选 


3. 扩展 账户 的 创建 过 程 以 添加 新 的 个 人 信息 
在 Web 页 面 注册 新 用 户 时 , 表单 数据 发 送 到 服务 器 进行 处 理 , 然后 存储 在 MongoDB 集 合 中 。 
为 了 扩展 默认 的 行为 , 可 以 在 用 户 创建 过 程 中 搬 和 人 钧 子 函数 , 用 来 检查 或 增强 将 要 存储 的 数据 。 
这 时 可 使 用 Accounts .oncreateUser () 困 数 , 它 以 一 个 函数 为 参数 。 这 个 参数 冰 数 在 每 次 创 
建新 用 户 时 被 调用 ,使 你 能 够 控制 新 用 户 文档 的 内 容 。 孔 数 本 身 使 用 两 个 参数 : options 和 


UUSEEe 























// server.js 

Accounts.onCreateUser (function (options, user) { 
user.profile = options.profile; 
return user; 


3 

options 对 象 来 自身 份 验 证 提供 者 ， 在 当前 情况 下 就 是 accounts-password。 它 来 自 客户 
端 ， 是 不 应 该 被 信任 的 。 默 认 情 况 下 ，oncreateUser 简 单 地 将 options .profile 复 制 到 
user.profile， 返 回 一 个 user 对 象 ， 该 对 象 表示 数据 库 中 新 创建 的 用 户 文档 。 

如 果 要 为 每 个 新 用 户 添 加 个 人 信息 ， 你 需要 将 代码 放 在 server/serverjs 文 件 中 (或 
Meteor.isServer 块 内 ), 计 我 们 保持 oncreateUser 的 默认 行为 , 将 身份 验证 提供 者 的 个 人 信 
息 复 制 到 用 户 文档 。 使 用 密码 时 ， 还 没有 个 人 信息 数据 ,但 当 你 稍 后 使 用 Facebook 或 Twitter 添加 
外 部 登录 时 ,就 可 以 使 用 它们 传递 过 来 的 个 人 信息 。 如 果 注 册 过 程 没 有 提供 个 人 信息 , 你 可 以 添 
加 一 个 空 的 对 象 。 返 回 用 户 文档 之 前 ， 一 个 新 的 个 人 信息 属性 rank 将 被 添加 到 每 个 用 户 ， 这 使 
他 们 成 为 一 个 “ 白 腰带 ”“， 所 和 需 的 代码 如 下 所 示 。 


代码 清单 6-4 ”为 新 用 户 添加 个 人 信息 
// server.js 
Accounts.onCreateUser (function (options, user) { 
if (options.profile) { 
user.profile = options.profile; 



























































二 





Q 我 们 将 在 这 里 使 用 大 多 数 武术 的 排名 系统 ， 用 户 从 白色 腰带 开始 ， 向 黑色 腰带 发 展 。 
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} 
else { 
user.profile = {}; 
} 
user.profile.rank = 'White belt'; 
return user; 


je 
从 现在 开始 ， 所 有 注册 用 户 的 用 户 文 档 中 都 将 有 一 个 个 人 信息 字段 。 但 已 有 的 用 户 并 不 受 
到 这 种 变化 的 影响 ， 这 是 因为 他 们 已 经 走 过 了 createUser 阶 段 ， 不 会 受到 上 面 这 个 新 功能 的 


时 /人 
影响 。 





提示 “如果 要 清除 数据 库 ， 使 用 命令 meteor reset。 这 样 将 清空 所 有 的 集合 ， 你 可 以 从 0 个 用 
户 开 始 。 


6.1.3 ”设置 邮件 


特别 地 ， 当 注册 需要 电子 邮件 地 址 时 ， 你 要 确保 该 地 址 是 有 效 的 。 对 于 重 置 密码 ，Meteor 
服务 器 必须 能 够 发 送 电子 邮件 给 用 户 。 如 果 不 配 置 emails 包 ， 所 有 的 消息 将 显示 在 服务 器 控制 
台 上 ， 但 不 会 发 送 实 际 的 邮件 ( 参见 图 6-5 )。 














©@O@e@ userApp 
=> App running at: http://localhost:3000/ 
I20141113-10:44:10.289(1)? ====== BEGIN MAIL #0 ====== 


I20141113-10:44:10.338(1)? (Mail not sent; to enable sending, set the MAIL_URL environment variable.) 
120141113-10:44:10.339(1)? MIME-Version: 1.0 

I20141113-10:44:10.339(1)? From: "Meteor Accounts" <no-reply@meteor.com> 

I20141113-10:44:10.339(1)? To: stephan@yauh.de 

I20141113-10:44:10.339(1)? Subject: How to reset your password on localhost:3000 
120141113-10:44:10.339(1)? Content-Type: text/plain; charset=utf-8 

I20141113-10:44:10.340(1)? Content-Transfer-Encoding: quoted-printable 

I20141113-10:44:10.340(1)? 

I20141113-10:44:10.340(1)? Hello, 

I20141113-10:44:10.340(1)? 

I20141113-10:44:10.340(1)? To reset your password, simply click the link below. 
I20141113-10:44:10.340(1)? 

I20141113-10:44:10.341(1)? http://localhost:3000/#/reset-password/LmpvMrBoEOBTlkdamj iomi-WC6LuwN3LELCW98Pr6Dr 
I20141113-10:44:10.341(1)? 

I20141113-10:44:10.341(1)? Thanks 

120141113-10:44:10.341(1)? 

I20141113-10:44:10.341(1)? ====== END MAIL #0 ====== 




















证 


图 6-5 除非 配置 了 电子 邮件 服务 器 ， 和 否则 Meteor 将 在 服务 器 控制 台 上 显示 电子 邮 伯 


正如 你 在 图 6-5 中 看 到 的 , Meteor 需 要 MAIL_URL 环 境 变 量 来 保存 SMTP 服 务 器 的 连接 字符 串 。 
使 用 环境 变量 是 个 快速 调整 配置 值 的 好 方法 。 和 把 邮件 服务 器 配置 添加 到 文件 中 比 起 来 , 它 在 大 
多 数 时 候 提 供 了 更 多 的 透明 度 。 

1. 添加 邮件 服务 器 

连接 到 邮件 服务 器 的 连接 细节 被 认为 是 高 度 敏感 的 。 你 不 希望 任何 人 找到 你 的 邮件 服务 器 凭 
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证 , 然后 开始 用 你 的 机 器 发 送 垃 圾 邮件 。 为 了 避免 让 所 有 用 户 看 到 这 个 登录 信息 ,请 一 定 不 要 在 
Meteor .isServer 块 中 配置 邮件 服务 器 ， 应 该 使 用 server 目 录 下 的 一 个 专用 文件 来 进行 配置 。 

Meteor 使 用 各 种 环境 变量 来 进行 配置 ,这 在 第 12 章 中 会 进行 概述 。 所 有 环境 变量 可 以 在 启动 
时 直接 传递 到 服务 器 上 ,也 可 以 在 代码 中 使 用 process .env.< 环 境 变量 的 名 字 > 来 设置 环境 变量 。 
要 设置 MAIL_URIL 为 一 个 有 效 的 邮件 服务 器 ， 你 需要 把 相关 命令 放 在 Meteor .startup () 函数 
中 ,这 样 每 次 Meteor 服 务 器 启动 时 它 就 会 被 执行 。 为 了 保持 代码 的 干净 ， 你 需要 使 用 变量 来 设置 
username、bassword、server 和 port ， 而 不 是 直接 写 SMTP 连 接 字 符 串 。 一 些 字符 在 连接 字 
符 串 中 需要 转 义 ， 因 此 每 个 变量 都 会 被 encodqeURIComponent 处 理 。 

一 且 把 代码 清单 6-$ 的 代码 添加 到 你 的 应 用 ， 你 的 应 用 将 能 发 送 电子 邮件 ， 比 如 向 所 有 提供 
了 邮件 地 址 的 用 户 发 送 密码 重 置 链 接 。 务 必 根 据 自 己 的 邮件 服务 器 配置 调整 变量 的 值 。 


代码 清单 6-5 在 serversmtp.js 中 配置 SMTP 服 务 器 















































Meteor .startup(function () { 

Smt Be: 
username: 'yourmail@gmail.com', 根据 你 的 SMTP 
password: 'mySecretPassword', 服务 器 ， 调 整 这 
server: 'smtp.gmail.com', 些 值 
port: S87 

区 

process.env.MAIL URL = 'Smtp://' + 


encodeURIComponent (smtp.username) + 
encodeURIComponent (smtp.password) + '@' + 
encodeURIComponent (smtp.server) + 
smtp.port; 


J 
现在 ， 该 应 用 就 能 够 发 送 电 子 邮件 ， 你 可 以 鼓励 用 户 注 册 时 验证 他 们 的 邮件 地 址 。 

















提示 通过 SMTP 发 送 邮 件 需 要 明文 传递 密码 。 为 了 更 好 的 安全 性 ， 你 可 以 使 用 环境 变量 而 不 是 
使 用 文件 来 存储 密码 ， 或 使 用 监听 smtp://localhost:25 的 本 地 sengdmail 服 务 ， 它 不 
需要 密码 。 


2. 发 送 电子 邮件 地 址 验证 邮件 

再 次 ， 你 会 使 用 oncreateUser 来 注册 一 个 钧 子 函数 ， 在 用 户 注册 之 后 ， 尽 快 发 送 一 封 验 证 
邮件 。 相 应 的 函数 为 sendverificationEmail, 它 需 要 两 个 参数 : 用 户 ID 和 一 个 可 选 的 电子 邮 
件 地 址 。 























Accounts.sendVerificationEmail (user._id, email); 


通常 只 有 第 一 个 参数 是 必要 的 , 因为 地 址 将 是 用 户 文档 的 一 部 分 。 但 因为 你 不 要 求 用 户 提 供 
电子 邮件 地 址 ， 所 以 你 应 该 小 心 ， 当 用 户 没 有 邮件 地 址 时 ,不 要 试图 发 送 电 子 邮 件 。 此 外 ,如果 
直接 钧 进 到 用 户 创建 过 程 中 ， 你 必须 等 待 Meteor 创 建 用 户 文档 之 后 才 可 以 访问 它 。 
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代码 清单 6-6 中 显示 的 代码 首先 检查 用 户 是 否 提供 了 电子 邮件 地 址 ， 然 后 设置 2 秒 的 等 待 ， 等 
待 账户 被 创建 ， 最 后 发 送 验证 电子 邮件 。 


代码 清单 6-6 在 创建 用 户 时 发 送 验 证 电子 邮件 


Accounts.onCreateUser (function (options, user) { 








Rs 只 有 用 户 提供 了 
user.profile.rank = 'White belt'; 地 址 才 这 样 做 
if (options.email) { < 
Meteor .SetTimeout (function () { < 一 一 多 EE Bs 
Accounts.sendVerificationEmail (user._id); 二 baad de 
}, 2 * 1000); 来 创建 一 个 用 户 
} 发 送 验证 文档 
return user; 电子 邮件 
}); 
3. 定制 邮件 














Meteor 中 ， 所 有 账户 相关 电子 邮件 的 发 送 者 、 邮 件 主题 和 正文 都 有 默认 设置 。 你 可 以 使 用 嘉 
欢 的 文字 来 调整 它们 。 表 6-2 解 释 了 如 何在 Accounts .emailTemplates 对 象 内 部 访问 这 些 设置 。 
也 可 参考 代码 清单 6-7， 看 看 它们 是 如 何 使 用 的 。 


表 6-2 ”调整 账户 相关 电子 邮件 的 可 用 字段 



































字段 名 称 描 述 注 记 
siteName 应 用 的 名 称 ， 如 “Meteor in Action App” 默认 值 : 应 用 的 DNS 名 称 ， 如 usersApp. 
meteor.com 

from RFC5322 兼 容 的 发 件 人 姓名 和 地 址 默认 值 : Meteor 账 户 no-reply@meteor.com 

resetPassword 包含 三 个 字段 ， 每 个 接受 一 个 函数 : subject、 text 与 subject 是 必需 的 ，html 是 可 选 的 
text、 html 

enrollAccount 包含 三 个 字段 ， 每 个 接受 一 个 国 数 : subject、 text 与 subject 是 必需 的 ，html 是 可 选 的 
text、 html 

verifyRmail 包含 三 个 字段 ， 每 个 接受 一 个 函数 : subject、 text 与 subject 是 必需 的 ，html 是 可 选 的 
text、 html 





正如 你 所 看 到 的 ，accounts-password 包 定义 了 它 可 以 发 送 的 三 种 不 同类 型 的 电子 邮件 。 
你 可 以 通过 使 用 相应 的 发 送 函 数 来 手动 触发 它们 : 
Accounts.sendResetPasswordEmail () 


Accounts.sendEnrollmentEmail () 
Accounts.sendVerificationEmail() 


在 用 户 创建 过 程 中 , 服务 器 发 送 一 封 验证 电子 邮件 。 让 我 们 自 定义 这 个 验证 电子 邮件 的 主题 
和 内 容 。 为 简单 起 见 ， 你 可 以 把 代码 清单 6-7 的 代码 添加 到 现 有 的 server/smtp.js 文 件 , 或 使 用 一 个 
专用 的 文件 server/mailTemplates.js。 它 必须 在 服务 玉环 境 中 运行 ， 否 则 浏览 右 将 抛 出 错误 。 
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代码 清单 6-7” 自 定义 账户 电子 邮件 模板 


调整 站 点 
名 称 不 会 
影响 用 户 
必须 点 击 

的 URL 





—>Accounts.emailTemplates.siteName = 'Meteor in Action userApp'; 
Accounts.emailTemplates.from = 'Stephan <stephan@meteorinaction.com>'; < 一 用 户 将 看 到 
泣 旦 
Accounts.emailTemplates.verifyEmail.subject = function (user) { 0 
return 'Confirm Your Email Address, ' + user.username; 件 人 
}; 
Accounts.emailTemplates.verifyEmail.text = function (user, url) { 
return 'Welcome to the Meteor in Action userApp!\n' 
+ 'To verify your email address go ahead and follow the link below: \n\n' 定义 验证 
+ url; 电子 邮件 
的 内 容 


Accounts.emailTemplates.verifyEmail.html = function (user, url) { 
return '<hl>Welcome to the Meteor in Action userApp!</h1l>' 
+ '<p>To <strong>verify your email address</strong> go ahead and follow the 
link below:</p>' 
+ url; 


$3 


尽管 你 很 容易 定义 HTML 电 子 邮 件 ， 但 是 请 记 住 ， 文 本 和 HTML 都 会 发 送 给 收 件 人 。 如 果 他 




















们 设置 了 他 们 的 电子 邮件 客户 端 优先 显示 纯 文 本 的 内 容 , 他 们 将 看 不 到 html 函数 中 定义 的 内 容 。 
因此 ， 请 确保 text 和 html 模 板 中 总 是 包含 相同 数量 的 信息 。 


看 到 它 仍 然 指 向 http://localhost:3000。 部 署 应 用 时 ， 你 必须 通过 环境 变量 设置 正确 的 URL。 如 果 
使 用 meteor deploy， 它 会 自动 带 你 设置 。 如 果 使 用 其 他 不 同 的 方法 来 部 署 应 用 ， 你 必须 把 




















现在 注册 为 一 个 新 用 户 时 ,你 将 收 到 一 封 自 定义 的 电子 邮件 , 其 中 有 个 人 验证 链接 。 你 可 以 




















ROOT_URL 设 置 为 正确 的 网 址 ， 方 法 是 启动 Meteor 时 设置 环境 变量 的 值 ， 如 下 所 示 : 


S ROOT_URL='http://ww.meteorinaction.com' meteor run 


或 者 ， 你 可 以 将 它 添加 到 代码 ， 并 将 其 包 在 startup 块 中 : 


// server.js 
Meteor.startup(function () { 
process.env.ROOT URL = 'http://ww.meteorinaction.com'; 


}); 





6.2 ”使 用 OAuth 认证 用 户 














通常 , 用 户 名 和 密码 不 是 用 户 登 录 应 用 的 唯一 选择 。 使 用 一 个 现 有 的 账户 登录 到 网 站 降低 了 





注册 的 门槛 , 它 不 需要 用 户 键入 任何 信息 。 此 外 ， 它 简化 了 应 用 的 使 用 ， 因 为 不 需要 记 住 额外 的 





登录 。 这 些 网 站 包括 : 


用 户 名 和 密码 。 














Meteor 的 发 行 版 中 带 有 多 个 用 户 认 证 提供 程序 , 允许 用 户 使 用 社交 网 站 用 户 而 不 是 本 地 用 户 











口 Facebook 
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口 GitHub 
口 Google 
口 Meetup 
口 Meteor Developer Account 
口 Twitter 
口 微 博 
所 有 这 些 都 基于 OAuth， 它 以 复杂 的 方式 将 认证 数据 从 一 个 站 点 传递 到 另 一 个 。 许 多 社区 软 
件 包 也 可 以 使 用 其 他 认证 机 构 进 行 认证 ,如 LinkedIn 或 Dropbox。 每 个 OAuth 提 供 者 的 基本 工作 原 
理 都 是 一 样 的 ， 所 以 我 们 不 会 逐个 讨论 。 











6.2.1 OAuth 介绍 





开放 式 认 证 (Open Authentication，OAuth ) 机 制 自 2007 开 始 已 经 流行 于 Web 应 用 中 。 背 后 的 
主要 想法 (参见 图 6-6 ) 是 使 用 诸如 Facebook 之 类 的 服务 提供 程序 来 对 用 户 进 行 身 份 验证 ， 并 允 
许 第 三 方 应 用 访问 通过 身份 验证 用 户 (访问 授权 ) 的 特定 信息 。 这 些 特定 信息 可 能 是 简单 的 用 户 
名 或 更 敏感 的 信息 ， 如 朋友 或 允许 在 用 户 墙 上 发 布 文章 。 


Meteor 应 用 应 用 ID: 12345 6 


(消费 者 ) 应 用 密 钥 : xxkeyyy 































4. 发 送 访问 令 牌 





2. 转发 登录 请 求 


3. 显示 登录 窗口 ， 询 
问 是 否 和 该 应 用 分 


享 信息 名 


用 户 
图 6-6 ”使 用 Facebook 作 为 服务 提供 者 的 OAuth 流 程 


如 图 6-6 所 示 ， 每 个 OAuth 情 景 中 有 三 个 主要 部 分 : 
口 一 个 服务 提供 商 ， 如 Facebook 或 Twitter; 
口 一 个 消费 者 ， 如 你 的 Meteor 应 用 ; 
口 用 户 ， 比 如 一 个 现 有 的 Facebook 用 户 和 希望 登录 到 你 的 Meteor 应 用 。 

许多 网 站 可 以 作为 OAuth 的 服务 提供 商 。 我 们 将 以 Facebook 为 例 来 说 明 这 个 过 程 。 我 们 的 
Meteor 应 用 必须 连接 到 Facebook。 通 过 在 Facebook 的 开发 者 网 站 上 创建 一 个 新 的 应 用 ， 可 以 做 到 
这 一 点 。 为 了 验证 我 们 的 应 用 不 是 一 个 恶意 脚本 ， 它 使 用 相应 的 应 用 标识 (application ID ) 和 密 
钥 (secretkey ) 来 识别 自己 。 这 基本 上 就 是 我 们 Meteor 服 务 器 进程 的 用 户 名 和 密码 。 一 旦 连接 建 
立 ， 我 们 就 可 以 让 用 户 用 他 们 的 Facebook 账 户 登 录 。 


1. i 上 我 使 用 Facebook 
小 


登录 
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不 需要 在 我 们 的 Meteor 应 用 中 输入 任何 凭证 , 用户 现 在 可 以 单 击 一 个 按钮 来 通过 Facebook 登 
录 。 假 设 他 们 已 经 登录 到 Facebook， 他 们 现在 会 看 到 一 个 对 话 框 ， 询 问 他 们 是 否 想 与 Meteor 应 用 
分 享 信息 。 在 这 个 场景 的 幕后 ，Facebook 为 服务 提供 者 ， 而 Meteor 应 用 已 经 将 登录 请 求 转发 给 
Facebook。 如 果 用 户 同 意 与 Meteor 应 用 共享 他 们 的 登录 信息 ，Facebook 将 生成 一 个 访问 令 牌 。 这 
个 令 牌 让 Meteor 应 用 知道 用 户 身份 已 经 被 正确 地 验证 ,并 被 授予 了 由 用 户 提 供 的 权限 。 在 最 简单 
的 情况 下 ，Meteor 可 能 只 有 读 取 用 户 电 子 邮 件 地 址 的 权限 。 根 据 配置 设置 ,我 们 还 可 以 请 求 更 多 
的 权限 ， 比 如 张贴 内 容 到 用 户 墙 。 

不 是 所 有 的 OAuth 提 供 者 支持 的 权限 都 一 样 ， 所 以 它们 都 必须 进行 单独 配置 。 使 用 OAuth 的 
优势 在 于 ， 如 果 拥 有 权限 ， 作 为 消费 者 的 应 用 可 以 直接 与 服务 提供 者 进行 数据 交换 。 这 样 ， 所 有 
Facebook 好 友 、 最 近 的 推 文 或 GitHub 上 私人 仓库 的 数量 都 很 容易 访问 并 添加 到 用 户 的 个 人 信息 。 













































































6.2.2 ”整合 Facebook 认证 


要 在 Meteor 应 用 中 整合 Facebook 的 OAuth 认 证 ， 可 执行 以 下 步 又。 

(1) 添加 accounts-facebook 包 。 

(2) 创建 一 个 新 的 Facebook 应 用 。 

(3) 配置 Facebook 集 成 。 

1. 向 应 用 添加 accounts-facebook 

第 一 步 是 添加 Facebook 作 为 应 用 的 身份 验证 提供 者 。 如 果 应 用 已 经 像 6.1 节 那样 支持 用 户 名 / 
密码 身份 验证 ， 添 加 一 个 包 就 足够 了 : 


$ meteor add accounts-facebook 


这 个 包 不 会 添加 任何 模板 到 应 用 。 因此 , 如 果 accounts-facebook 是 项 目 中 唯一 可 用 的 包 ， 
你 就 需要 在 模板 中 手动 调用 所 有 的 功能 。 或 者 你 可 以 添加 accounts-ui 包 ， 它 提供 了 登录 框 ， 
不 仅 可 用 于 密码 认证 也 可 用 于 许多 OAuth 服 务 。 

所 有 的 OAuth 包 都 需要 进行 配置 。 像 用 户 一 样 , 这 些 配置 存储 在 MongoDB 和 集合 中 ,一 旦 OAuth 
服务 被 配置 ， 集合 meteor_accounts_login-ServiceConfigurat ion 就 会 被 创建 。 挂 起 的 凭 
证 会 被 暂时 存储 在 一 个 专用 的 集合 中 。 这 个 集合 在 服务 器 启动 时 创建 ， 名 为 meteor_OAuth 
_pendingCredentialso 

没有 必要 手动 访问 这 两 个 集合 中 的 任何 一 个 。Meteor 只 在 内 部 使 用 它们 ， 直 接 查 询 它 们 的 数 
据 没有 任何 好 人 处。 

2. 创建 一 个 Facebook 应 用 

如 果 IMeteor 找 不 到 Facebook 集 成 的 配置 ， 用 户 界面 会 显示 一 个 红色 的 Configure Facebook 
Login( 配置 Facebook 登 录 ) 的 按钮 ， 而 不 是 普通 的 登录 按钮 。 单 击 它 将 会 看 到 一 个 简短 的 配置 
指南 以 及 两 个 需要 你 提供 的 字段 ， 即 应 用 ID 和 密 钥 。 

你 需要 将 自己 注册 为 一 个 Facebook 开 发 者 ， 这 是 免费 的 ,但 你 需要 有 一 个 Facebook 账 户 。 你 
可 以 在 https://developers.facebook.com 创 建 一 个 新 的 Facebook 应 用 。 然后 在 应 用 选项 卡 下 添加 一 个 
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新 的 Web/WWW 类 型 的 应 用 。 接 下 来 你 会 设置 应 用 ID , 这 可 以 是 任何 有 助 于 你 和 你 的 用 户 识别 该 
应 用 的 名 字 。 你 的 用 户 最 终 会 看 到 这 个 应 用 的 名 称 , 所 以 好 的 做 法 是 使 用 网 站 名 称 或 能 贴切 描述 
该 应 用 的 名 字 。 应 用 的 类 别 以 及 它 是 否 是 男 一 个 Facebook 应 用 的 测试 版 本 不 会 对 功能 有 任何 影 
响 ， 所 以 可 以 设置 为 能 最 好 描述 你 的 项 目的 值 。 

关于 Facebook 应 用 的 URL, 在 本 地 开发 环境 中 使 用 时 通常 应 该 设置 为 http://localhost:3000。 你 
可 以 从 Meteor 所 显示 的 配置 对 话 框 中 得 到 正确 的 URL 设 置 。 

一 旦 你 已 经 完成 了 这 些 设置 ,在 激活 这 个 应 用 之 前 ，Facebook 需 要 你 为 该 应 用 设置 一 个 用 来 
联系 的 电子 邮件 地 址 。 进 入 到 Facebook 开 发 者 网 站 上 的 应 用 控制 面板 , 在 设置 部 分 输入 联系 人 电 
子 邮 件 (参见 图 6-7 )。 最 后 ， 你 需要 在 Status & Review 选 项 卡 上 激活 该 应 用 。 


















































显示 给 用 户 的 OAuth 配 置 的 
应 用 名 称 凭证 
















Advanced 。 
此 应 用 的 联系 人 地 址 6 

@ Deshpoard a App Secret 
类 Settings 321121934741156 cc e000eeee Show | 

Display Name Namespace 
六 Status & Review 

meteor-locaklogin 

页 App Detalls App Domains Contact Email 
& Roles info@meteorinaction.com 
叹 Open Graph Website Quick Start | x 
A Alers Site URL 
ei http:/ocalhost:3000/ 

可 以 访问 该 Meteor 

应 用 的 网 址 





图 6-7 用 于 与 Meteor 集 成 的 Facebook 应 用 的 设置 





三 | 


激活 的 Facebook 应 用 可 以 用 来 验证 用 户 。 通 过 Facebook 实 现 登 录 的 最 后 一 步 是 配置 Meteor 
应 用 。 


3. 配置 
在 浏览 器 中 打开 Meteor 应 用 ， 然 后 单 击 Facebook 按 钮 ， 调 出 图 6-8 所 示 的 配置 对 话 框 。 
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车 


Configure Service 


First, you'll need to register your app on Facebook. Follow these steps: 


1. Visit https://developers.facebook.com/apps 

2. Click "Add a New App". 

3, Select "Website" and type a name for your app. 

4. Click "Create New Facebook App ID". 

5. Select a category in the dropdown and click "Create App ID". 

6. Under "Tell us about your website", set Site URL to: http://localhost:3000/ and click 
"Next". 

7. Click "Skip to Developer Dashboard ". 

8. Go to the "Settings" tab and add an email address under "Contact Email". Click 
"Save Changes". 

9. Go to the "Status & Review" tab and select Yes for "Do you want to make this app 
and all its live features available to the general public?". Click "Confirm". 

10. Go back to the Dashboard tab. 


Now, copy over some details. 


AppID 321121934741156 
App Secret 3f2672f0451e91b0c4df 


Choose the login style: 


© Popup-based login (recommended for most applications) 
O Redirect-based login (special cases explained here) 


图 6-8 ”集成 Facebook 的 配置 对 话 框 


除了 有 关 如 何 创建 一 个 Facebook 应 用 的 基本 说 明 ， 配置 对 话 框 可 以 让 你 添加 应 用 凭证 (应 用 
ID 和 应 用 密 钥 ) 以 及 登录 样式 。 默 认 使 用 弹出 式 (pop-up-based ) 对 话 框 ， 这 意味 着 当 用 户 登 录 
到 Facebook 时 , Facebook 对 话 框 将 在 原 应 用 窗口 之 上 弹出 。 与 之 相反 , 基于 重 定向 (redirect-based ) 
的 登录 样式 将 离开 应 用 , 将 当前 的 浏览 器 窗口 重 定向 到 Facebook, 一旦 身份 验证 成 功 将 重新 加 载 
整个 应 用 。 除 非 你 计划 在 移动 设备 上 的 Cordova 容 器 内 运行 应 用 "， 和 否则 最 好 使 用 弹出 式 登 录 。 

保存 配置 ， 然 后 用 户 就 可 以 通过 Facebook 登 录 。 如 果 配 置 错 误 ， 你 可 以 从 MongoDB 中 的 
meteor_accounts_loginServiceConfiguration 和 集合 中 手动 删除 配置 信息 。 使 用 Robomongo 

这 样 的 应 用 或 在 命令 行 上 使 用 meteor mongo 命 令 进 入 Mongo shell， 然 后 使 用 下 面 的 命令 : 


db.getCollection('meteor_ accounts_loginServiceConfiguration') .remove({service: 
'facebook'}) 


如 果 使 用 meteor reset 清 空 所 有 的 集合 ， 所 有 的 登录 服务 配置 也 将 被 重 置 。 

































































说 明 有 的 OAuth 配 置 都 存储 在 应 用 数据 库 中 。 每 当 你 使 用 meteor reset 命 令 清空 数据 库 ， 也 
将 从 数据 库 中 删除 所 有 OAuth 配 置 数据 。 


只 要 数据 库 中 没有 可 用 的 Facebook 赁 证， 任何 访 问 该 应 用 的 用 户 都 可 以 通过 浏览 器 来 配置 
为 了 各 这 一 点 ， 你 可 以 在 应 用 的 源码 中 添加 一 些 OAuth 任 证。 如 果 数 据 库 中 没有 配置 好 的 
和 凭证, 这些 赁 证 将 被 自动 插入 数据 库 ， 就 像 我 们 在 前 面 章节 中 使 用 的 夹具 一 样 。 这 需要 一 个 称 为 

















@ 请 参考 第 11 章 中 Isobuild 相 关 的 内 容 ， 以 了 解 更 多 关于 在 移动 设备 上 运行 Meteor 应 用 的 知识 。 
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service-configuration 的 包 : 


$ meteor add service-configuration 


一 旦 该 包 可 用 ,代码 清 单 6-8 中 的 代码 会 在 Meteor 启 动 应 用 时 为 Facebook 设 置 正 确 的 OAuth 凭 证 。 
代码 清单 6-8 ”在 server/serverjs 中 插入 Facebook OAuth 配 置 的 夹具 


if (ServiceConfiguration.configurations.findl(t{ 

service: 'facebook' 

GE 人 EU 

ServiceConfiguration.configurations .insett({ 
service: 'facebook', 
appId: 'OAuth-credentials-from-facebook', 
secret: 'OAuth-credentials-from-facebook', 
loginStyle: 'popup' 

已 





} 


4. 在 用 户 个 人 信息 中 添加 Facebook 信 息 

对 通过 Facebook 登 录 的 所 有 用 户 来 说 ， 他 们 的 用 户 文档 services 字 有 段 中 都 有 一 个 新 的 条 目 
( 见 代码 清单 6-9 )。 它 包含 用 于 身份 验证 的 令 牌 ， 还 包括 姓 、 名 、 人 性 别 和 电子 邮件 等 信息 。 如 果 
你 想 允 许 用 户 编辑 此 信息 ， 则 可 简单 地 将 此 数据 复制 到 用 户 文档 中 的 profile 对 象 。 


代码 清单 6-9 ”通过 Facebook 注 册 的 用 户 文档 
上 

















"_id" : "nzPMRAdNSKX7NJVvVTGY", 
"createdAt" : ISODate("2015-03-30T21:23:55.4752")， 
"profile" : { 
一 > "name" : "Stephan Hochhaus" 
Ys 
"services" : { 
Meteor "facebook" : { 
将 自动 "accessToken" : "CAAEkKDWbZAj..... 号 
在 个 人 "email" : "stephan@meteorinaction.com", 
言 息 中 "expiresAt" : 1421097429424, 
添加 名 "first_ name" : "Stephan", 
称 属性 "gender" : "male", 
The ,W234967890, 
"last_name" : "Hochhaus", 
"link" : "https://www.facebook.com/app_scoped user id/123456789/", 
"Jocale" : "en_US"， 
p> "name" : "Stephan Hochhaus" 
起 
"resume" : { 


} 
. 
} 


正如 你 在 代码 清单 6-9 中 看 到 的 ，Meteor 已 经 把 Facebook 的 name 属 性 复制 到 用 户 的 个 人 信息 
中 。 再 次 使 用 钧 子 Accounts .oncreateUser， 你 可 以 将 Facebook 提 供 的 数据 复制 到 用 户 的 个 人 
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信息 中 。 你 将 从 user .services.facebook 中 复制 姓 、 名 和 性 别 到 user.profile， 使 用 户 可 
以 独立 于 Facebook 在 Meteor 应 用 内 部 编辑 此 信息 。 

代码 清单 6-10 显 示 了 如 何 扩展 oncreateUser 钩 子 来 复制 facebook.service 的 字段 到 
profile， 这 只 有 当 用 户 已 通过 Facebook 登 录 时 才 可 工作 。 这 样 ， 它 也 可 以 与 代码 清单 6-6 中 的 
代码 合并 ， 添 加 用 于 密码 验证 的 profile 字 段 。 


代码 清单 6-10 ”在 用 户 个 人 信息 中 添加 Facebook 信 息 
Accounts.onCreateUser (function (options, user) { 
if (user.services.facebook){ 
user.profile.first name = user.services.facebook.first name; 
user.profile.last_ name = user.services.facebook.last_name; 
user.profile.gender = user.services.facebook.gender; 
} 
return user; 
提交 
即使 Facebook 已 更 新 了 姓名 或 性 别 信息 ， 也 不 会 更 新 用 户 的 个 人 信息 ， 因 为 oncreateUser 


函数 只 在 用 户 第 一 次 使 用 Facebook 登 录 到 应 用 的 时 候 被 调用 。 


6.2.3 ”集成 其 他 的 OAuth 提供 者 


如 前 所 述 ，Meteor 提 供 了 多 个 包 ， 人 允许 整合 其 他 的 社交 网 络 作为 身份 验证 提供 者 。 其 基本 原 
理 是 不 变 的 。 在 配置 外 部 验证 服务 商 之 前 ， 必 须 在 Twitter 、Google 、GitHub 或 任何 计划 整合 的 服 
务 网 站 上 创建 一 个 应 用 。 其 中 一 些 服务 商 要 求 设置 一 个 已 验证 的 或 回调 的 URL。 如 果 应 用 正在 开 
发 ， 这 通常 是 http:Wlocalhost:3000。 因 此 ， 一 个 好 的 做 法 是 在 服务 商 上 创建 两 个 应 用 : 一 个 用 于 
本 地 开发 环境 ， 另 一 个 用 于 Meteor 应 用 的 线 上 实例 。 

在 应 用 中 使 用 其 他 的 身份 验证 方法 

Meteor 让 在 应 用 中 添加 多 个 身份 验证 提供 者 变 得 简单 。 但 这 些 身 份 验证 提供 者 不 会 与 消费 者 
共享 相同 的 数据 ， 这 在 许多 情况 下 使 得 将 不 同 的 登录 方法 与 同一 用 户 联系 起 来 变 得 很 复杂 。 

想象 一 个 应 用 通过 用 户 名 和 密码 进行 身份 验证 ， 它 也 允许 通过 Twitter 和 Facebook 进 行 身份 验 
证 。 某 一 天 ， 某 用 户 可 能 决定 使 用 Twitter 登录 ， 而 另 一 天 ， 他 又 决定 使 用 Facebook 登 录 。 应 用 怎 
样 知 道 他 是 同一 个 用 户 呢 ? 用 户 Twitter 账 户 的 电子 邮件 地 址 可 能 会 与 Facebook 账 户 的 邮件 地 址 
相同 。 不 幸 的 是 ，Twitter 并 没有 在 身份 验证 API 中 暴露 用 户 的 电子 邮件 地 址 。 因 此 ，Meteor 不 能 
将 一 次 Twitter 登录 和 一 个 Facebook 账 户 联系 起 来 。 它 会 假设 这 是 两 个 用 户 。 在 最 坏 的 情况 下 ， 用 
户 通过 应 用 提供 的 每 个 登录 方法 进行 登录 ， 都 将 得 到 该 应 用 的 一 个 不 同 的 账户 。 

当然 , 完全 可 能 在 同一 个 应 用 中 使 用 多 个 身份 验证 提供 者 , 并 允许 用 户 使 用 它们 来 识别 单个 
用 户 。 要 这 样 做 ， 需 要 用 户 手动 将 这 些 个 人 信息 关联 到 同一 账户 。 不 幸 的 是 ， 这 个 功能 并 不 是 提 
供 账户 功能 的 核心 包 的 一 部 分 。 

一 些 社区 包 可 以 使 你 不 必 自 己 创 建 模板 和 代码 就 能 允许 用 户 将 多 个 社交 网 络 连接 到 同一 个 
账户 。 如 果 你 想 在 一 个 应 用 中 包括 多 个 身份 验证 提供 者 , 可 以 看 看 splendido:accounts-meld 
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或 bozhao:link-accounts。 
在 向 应 用 添加 过 多 的 身份 验证 提供 者 之 前 ， 考 虑 一 下 哪些 是 真正 需要 的 。 事 ? 
Meteor 中 使 用 OAuth 如 此 简单 ， 可 能 会 导致 过 于 复杂 但 对 用 户 无 益 的 应 用 。 
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用 户 认 证 是 不 够 的 , 你 还 需要 授权 用 户 的 行为 。 权限 可 以 用 来 定义 用 户 可 以 访问 的 数据 和 可 
以 使 用 的 功能 。 管 理 员 应 该 能 够 执行 所 有 可 能 的 操作 ， 而 普通 用 户 只 能 编辑 或 删除 自己 的 数据 。 

为 了 更 好 地 说 明 如 何 管理 用 户 权 限 , 让 我 们 来 使 用 一 个 简单 的 消息 应 用 。 你 可 以 在 本 章 的 示 
例 代 码 中 找到 源码 。 它 提供 了 有 限 的 功能 ， 但 这 使 它 更 容易 说 明 Meteor 权 限 系 统 中 的 要 点 。 

用 户 可 以 用 一 个 用 户 名 和 密码 注册 。 他 们 登录 后 ,应 用 显示 了 一 个 用 户 列表 ， 每 个 用 户 都 可 
以 通过 单 击 它们 来 选择 。 单 击 用 户 后 , 用户 I 有 D 将 被 赋 给 一 个 session 变 量 , 第 二 个 模板 将 显示 基 
本 的 个 人 信息 ， 人 允许 用 户 查看 和 留言 。 只 有 留言 板 的 所 有 者 可 以 删除 消息 。 

在 这 个 示例 应 用 中 实现 的 所 有 功能 都 基于 第 3 章 ( 模板 ) 和 第 4 章 (数据 ) 的 内 容 ， 还 有 一 些 
本 章 开头 关于 用 户 账 户 的 内 容 。 

就 像 前 面 章节 中 已 经 强调 过 的 ，Meteor 在 每 个 新 建 的 应 用 中 使 用 了 insecure 的 包 。 这 人 允许 
客户 端 和 每 个 用 户 , 包括 通过 和 没有 通过 身份 验证 的 用 户 , 保存 或 删除 数据 库 中 的 数据 。 向 应 用 
中 添加 安全 性 的 第 一 步 是 用 以 下 的 命令 删除 这 个 包 : 


$ meteor remove insecure 


删除 insecure 包 的 结果 是 ， 没 有 用 户 能 够 写 人 到 数据 库 了 。 查 看 数据 是 可 以 的 ， 因 为 
autopublish 包 仍然 可 用 。 我 们 将 在 下 一 章 中 讨论 如 何 删 除 它 。 首 先 ， 我 们 将 集中 精力 来 限制 
用 户 的 权限 。 

Meteor 中 ， 管 理 用 户 权限 最 简单 的 形式 是 对 集合 使 用 al11ow/deny 函 数 。 
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使 用 allow 和 deny 管理 权限 


默认 情况 下 , Meteor 信 任 服务 器 上 执行 的 所 有 代码 。 但 所 有 客户 端的 代码 都 认为 是 不 安全 的 ， 
特别 是 删除 insecure 包 以 后 。 从 浏览 絮 中 进行 任何 插入 、 更 新 或 删除 数据 库 集合 ， 都 会 得 到 一 
个 拒绝 访问 (Access denied ) 的 消息 。 











说 明 允许 和 拒绝 只 会 影响 数据 库 的 写 操作 。 集 合 读 取 可 以 使 用 发 布 ( Publication ) 和 订阅 
( Subscription ) 来 控制 。 








每 个 集合 都 暴露 了 一 个 allow 函 数 和 deny 孙 数 , 它们 可 以 用 来 限制 或 授予 用 户 权 限 。 代码 清 
单 6-11 显 示 了 它 的 语法 ，allow 和 aqeny 采 用 相同 的 语法 。 该 代码 必须 在 服务 器 环境 中 运行 , 但 在 
客户 端 中 运行 它 也 是 安全 的 。 因 此 ,， 它 可 以 放 在 定义 集合 的 文件 中 , 这 样 可 消除 一 些 元 余 。 如 果 
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你 喜欢 ,也 可 以 把 它 放 在 一 个 只 在 服务 器 上 使 用 的 文件 中 。 无 论 哪 种 方式 ,客户 端 都 不 能 更 改 服 
务 器 的 代码 ， 绕 过 权限 限制 ， 即 使 你 将 这 些 代 码 发 送 到 浏览 器 。 


代码 清单 6-11 在 消息 (Messages ) 集合 中 使 用 allow 
// collections.js 
MessagesCollection = new Mongo.Collection('messages'); 
MessagesCollection.allow({ 
insert: function (userId, doc) { 
return true; 
js 
update: function (userId, doc) { 
return true; 
remove: function (userId, doc) { 
return true; 
3} 
他 
可 以 定义 多 重 允许 和 拒绝 规则 ,， 有 了 时 它们 会 重 释 。Meteor 首 先 执 行 所 有 aeny 回 调 函 数 来 决定 
是 否 禁 止 某 个 动作 。 如 果 有 某 个 aeny 回 调 函 数 返回 true， 那 么 用 户 将 无 法 执行 相关 的 操作 ， 即 
使 有 一 个 allow 规 则 返回 Erue。 如 果 有 多 个 允许 规则 , 必须 只 有 一 个 相 匹配 的 动作 并 返回 Erue， 


这 样 才能 允许 用 户 执行 这 个 动作 。 











说 明 allow 和 aeny 回 调 函 数 只 影响 直接 写 入 数据 库 的 操作 ， 而 不 是 Meteor 的 方法 调用 。 方 法 
将 在 下 一 章 中 详细 讨论 。 





在 没有 insecure 包 的 情况 下 ,你 可 以 使 用 MessagesCollection.allow 来 启用 消息 发 送 ， 
也 可 以 将 删除 消息 的 权限 限于 它 的 收 件 人 。 

1. 向 用 户 发 送 消息 

通过 选择 一 个 用 户 ,每 个 登录 的 用 户 可 以 发 送 一 个 消息 到 另 一 个 用 户 ,每 个 消息 文档 包含 五 
个 字段 : 
口 _ia， 消 息 文档 的 唯一 标识 ; 
D sendqer， 消 息 作者 的 用 户 ID ; 
D zxecipient， 消 息 接收 者 的 用 户 ID 
D message， 实 际 的 消息 文本 ; 
口 timestamp， 消 息 的 创建 日 期 。 

在 浏览 需 中 创建 一 个 新 的 消息 文档 是 不 可 能 的 , 除非 a11low 回 调 函 数 返回 tLrue。 只 有 登录 的 
用 户 才能 够 发 送 一 个 消息 ， 所 以 当 有 用 户 ID 的 用 户 试图 插入 一 个 新 文档 时 需要 返回 true ( 见 代 
码 清单 6-12 )。 客 人 没有 用 户 ID ， 因 此 他 们 的 userIq 值 将 返回 false。 
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代码 清单 6-12 允许 登录 用 户 插入 新 消息 
MessagesCollection.allow({ 
insert: function (userId, doc) { 
return userId; 
} 
于 
要 注意 ， 此 授权 可 以 让 用 户 将 任何 消息 插入 数据 库 。 唯 一 的 限制 是 ， 用 户 登 录 并 写 人 
messages 集 合 。 新 的 字段 会 动态 添加 ， 例如， 用 户 可 添加 一 个 额外 的 字段 messageSubtext。 
为 了 防止 用 户 添 加 新 的 字段 到 文档 ， 可 以 使 用 一 个 拒绝 规则 来 检查 是 否 提 供 了 所 有 已 定义 的 字 
段 ， 并 且 没 有 字段 丢失 。 代 码 清单 6-13 中 说 明了 如 何 使 用 Meteor 中 的 Underscore.js 库 来 提取 所 有 
文档 字段 到 一 个 数组 。 使 用 另 一 个 包含 所 有 有 效 字段 名 的 数组 ， 你 可 以 确认 没有 强制 字段 丢失 ， 
也 没有 来 自 客 户 端的 额外 字段 。 搬 入 数据 时 ，_ia 字 段 将 自动 添加 到 数据 库 中 。 因 此 它 不 由 客户 
端 发 送 ， 也 不 在 插入 方法 的 有 效 字 段 数 组 validFielgs 中 。 


代码 清单 6-13 ”拒绝 带 有 丢失 或 附加 字段 的 插入 


















































利用 Underscore.js 
MessagesCollection.deny({ 把 所 有 的 文档 字段 
insert: function (userId, doc) { 名 放 进 数组 
var fieldsInDoc = _.keys (doc); < 一 
var validFields = ['sender', 'recipient', 'timestamp', 'message']; 
if (_.difference(fieldsInDoc, validFields).length > 0) { 二 一 
console.log('additional fields found'); 检查 额外 
return true; 的 或 丢失 
el 的 字段 
console.log('all fields good'); 





return false 
} 
} 

起 
虽然 已 有 效 地 确保 新 的 用 户 文档 中 只 有 已 知 的 字段 ， 但 你 无 法 对 这 些 字 段 的 内 容 进 行 控制 。 
用 户 可 以 设置 发 件 人 为 一 个 字符 串 ， 也 可 以 是 一 个 对 象 或 数组 ， 甚 至 是 二 进 制 blob。 

虽然 使 用 允许 /拒绝 规则 不 是 太 复杂 ， 但 它们 应 该 只 用 于 相对 简单 的 任务 ， 和 否则， 维护 复 杂 
性 不 断 增 长 的 规则 将 变 得 麻烦 。 添 加 到 应 用 中 的 规则 越 多 ， 就 越 难 分 辨 哪些 情况 将 被 拒绝 ,哪些 
将 被 允许 。 


























说 明 为 了 更 好 地 控制 数据 库 操作 ,请 考虑 使 用 Meteor 的 方法 而 不 是 允许 /拒绝 规则 。 第 7 章 将 提 
供 关 于 方法 的 全 面 介绍 。 


2. 从 白板 上 删除 消息 
如 果 收 件 人 不 喜欢 消息 的 内 容 ,他 应 该 能 够 删除 邮件 。 但 不 是 每 个 人 都 可 以 删除 消息 ， 
收 件 人 才能 够 这 样 做 。 




















多 
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你 不 能 设置 一 个 全 局 的 规则 来 拒绝 所 有 的 删除 操作 , 然后 为 接收 者 添加 一 个 允许 规则 。 请 记 
住 ， 只 要 有 一 个 拒绝 规则 返回 true 就 将 阻止 其 他 的 允许 规则 执行 。 因此， 需要 使 用 单个 的 拒绝 
规则 来 检查 要 求 删 除 邮 件 的 用 户 是 否 与 收 件 人 相同 。 代 码 清单 6-14 中 的 拒绝 规则 中 ， 如 果 当 前 登 
录用 户 的 userIgd 不 同 于 消息 文档 中 的 recipient 字 段 ， 它 将 返回 true。 


代码 清单 6-14 ”拒绝 收 件 人 以 外 的 其 他 人 删除 消息 
MessagesCollection.deny({ 
remove: function (userId, doc) { 
return doc.recipient !== userId; 
} 
下 站 好 
拒绝 代码 最 终 运 行 在 应 用 的 服务 器 端 , 即使 你 把 代码 放 在 一 个 客户 端 和 服务 器 端 都 可 以 访问 
的 文件 中 。userIq 参 数 由 accounts 包 直接 提供 ， 它 是 确定 的 并 被 传递 给 服务 器 上 的 remove 画 
数 。 在 浏览 器 控制 台中 ， 无 法 更 改 这 个 值 以 假冒 为 另 一 个 用 户 的 ID。 
3. 删除 用 户 账户 
users 集 合 是 特殊 的 ， 这 体现 在 几 个 方面 。 其 中 一 个 就 是 ， 默 认 情 况 下 ， 用 户 只 能 编辑 个 人 
言 息 字 段 的 内 容 。 即 使 没有 专用 的 允许 规则 ， 新 用 户 仍然 可 以 注册 并 创建 一 个 新 的 用 户 文档 。 一 
且 insecure 包 删除 ， 删 除 一 个 用 户 ， 即 使 是 他 自己 的 账户 ， 也 是 不 可 能 的 。 但 在 users 集 合 上 
使 用 一 个 简单 的 允许 规则 就 可 以 删除 账户 了 ( 见 下 面 的 代码 清单 )。 


代码 清单 6-15 ”允许 用 户 删除 他 们 的 账户 


Meteor.users.allow({ 
remove: function (userId, doc) { 
return doc._id === userId; 
9 
上 













































































提示 如 果 你 需要 对 用 户 授权 有 更 多 的 控制 ， 看 看 角色 包 alanning:roles 或 nicolas- 
lopezj:roles。 它 们 允许 你 实现 用 户 组 ， 比 单独 的 允许 和 拒绝 规则 更 透明 。 


6.4 总结 


在 本 章 中 ,你 已 经 了 解 到 : 

口 Meteor 自 带 多 个 账户 包 ， 支 持 用 户 注册 和 登录 ; 

口 可 以 通过 环境 变量 或 代码 连接 到 SMTP 服 务 器 ; 

口 系统 的 电子 邮件 可 以 通过 调整 它们 自己 的 Template 对 象 来 修改 ; 

口 OAuth 整 合 是 Meteor 的 一 个 核心 功能 ， 只 需要 很 少 的 工作 就 能 实现 ; 

口 可 以 使 用 allow 和 aeny 来 实现 简单 的 数据 库 权 限 管理 ; 

口 对 于 更 复杂 的 权限 设置 ， 应 该 用 Meteor 的 方法 而 不 是 a11ow 和 deny 规 则 。 


























数据 交换 








本 章 内 容 

口 在 没有 autopublish 包 支持 的 情况 下 发 布 collection 
口 使 用 模板 级 订阅 

口 用 参数 化 订阅 限制 客户 端 数据 

口 创建 新 的 聚合 数据 源 

口 使 自 定义 数据 源 具 有 响应 性 

口 用 服务 器 端 方法 保护 应 用 程序 




















在 开发 的 早期 阶段 , 让 服务 器 上 数据 库 的 内 容 可 以 在 客户 端 上 访问 经 常 是 有 帮助 的 。 增 加 便 
利 性 的 代价 是 性 能 和 安全 性 。 如 果 想 要 构建 低 延 迟 、 高 性 能 的 Web 应 用 程序 ， 你 必须 避免 在 每 个 
客户 端 上 复制 整个 数据 库 。 此 外 , 共享 所 有 数据 可 能 也 会 共享 那些 敏感 的 信息 ， 比 如 那些 仅 应 由 
它 的 所 有 者 查看 的 数据 。 因 此 ， 你 必须 取消 数据 自动 发 布 ， 重 新 获得 对 所 有 数据 库 内 容 的 控制 。 

本 章 介绍 了 Meteor 工 作 中 的 两 个 关键 概念 : 发 布 和 方法 ( 参见 图 7-1 )。 



































通过 在 服务 器 上 添加 验证 ， 方 法 让 
数据 库 的 写 入 变 得 安全 
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发 布 可 以 限制 发 送 
给 特定 客户 的 数据 











图 7-1 ”发布 和 方法 让 开发 人 员 可 以 完全 获得 对 数据 处 理 的 控制 


132 第 7 章 数据 交换 





使 用 Meteor 的 发 布 和 订阅 ,你 不 仅 可 以 控制 有 多 少数 据 可 以 发 送 到 每 个 客户 端 ， 而 且 可 以 控 
制 哪些 字段 对 哪些 用 户 是 可 用 的 。 在 本 章 中 , 你 将 学 习 如 何在 服务 器 上 设置 数据 发 布 , 使 你 的 应 
用 能 够 轻松 容纳 成 二 上 万 的 数据 库 文档 ,而 只 向 客户 端 发 送 一 个 小 的 子 集 。 这 样 就 可 以 有 效 地 解 
决 许多 可 能 出 现 的 性 能 问题 。 

第 6 章 我 们 讨论 了 使 用 允许 /拒绝 规则 来 保护 数据 库 的 写 操作 。 作 为 Meteor 远 程 过 程 调用 的 方 
法 是 这 些 简单 规则 的 强大 替代 品 。 方 法 可 以 在 服务 顺 或 客户 端 上 运行 。 通 过 合理 地 验证 客户 端 发 
送 的 所 有 内 容 , 可 以 使 用 它们 来 确保 所 有 的 数据 库 写 操作 都 是 安全 的 。 它 们 的 使 用 不 仅 限于 数据 
库 操作 ， 也 可 以 用 于 其 他 操作 ， 如 发 送 电子 邮件 等 。 

在 本 章 中 ,你 将 改进 一 个 应 用 , 使 它 更 加 健壮 并 足以 部 署 到 互联 网 。 这 个 应 用 将 存储 一 些 锯 
炼 的 数据 ， 它 包含 了 以 下 儿 个 方面 : 

口 手动 定义 发 布 和 订阅 ; 

口 通过 参数 化 订阅 限制 发 送 到 客户 端的 数据 ; 
口 聚合 数据 ; 

口 将 数据 限制 给 特定 的 用 户 ; 

口 使 用 方法 进行 数据 库 安全 写 人 。 

锻炼 的 跟踪 是 非常 简单 的 , 所 有 代码 将 放 在 五 个 文件 中 。 你 将 使 用 fixtures.js 文 件 将 随机 的 锻 
炼 数据 放 入 集合 。 看 看 本 章 的 示例 代码 ， 看 它 是 如 何 工 作 的 : 


client 
workoutTracker.html 
workoutTracker.js 
collections 

Workouts.js 

——— server 






















































































fixtures.js 
publications.js 





7.1 发 布 和 订阅 


到 目前 为 止 , Meteor 使 用 autopublish 包 自动 将 所 有 的 集合 数据 发 布 给 所 有 的 客户 端 , 这 个 
包 不 适合 用 于 生产 环境 ， 因 为 它 不 会 限制 发 送 给 客户 端的 数据 量 。 在 开发 过 程 中 , 它 可 以 很 好 地 
工作 在 包含 少量 数据 的 数据 库 上 , 但 它 不 能 很 好 地 扩展 到 数 百 或 数 千 文档 的 规模 。 此 外 ， 它 不 提 
供 任何 访问 限制 ， 每 个 客户 端 都 可 以 访问 所 有 的 数据 。 在 这 一 节 中 ,你 将 学 习 如 何以 有 效 和 安全 
的 方式 向 客户 端 发 送 数据 。 

这 个 应 用 将 会 存储 如 跑步 或 骑 自 行车 的 锻炼 数据 ， 并 将 它们 在 一 个 简单 的 表 中 呈现 给 用 户 。 
所 有 的 锻炼 将 存储 在 一 个 集合 中 ,其 中 包含 锻炼 发 生 的 日 期 和 距离 。 应 用 会 在 启动 时 创建 大 量 的 
样本 锻炼 文档 ,并 在 一 个 表 中 显示 所 有 文档 。 因 为 不 希望 客户 端 立即 加 载 所 有 数据 ,你 将 限制 加 
载 到 客户 端的 锻炼 数据 量 ， 然 后 添加 一 个 按钮 ， 每 次 单 击 该 按钮 可 获取 更 多 的 数据 。 最 后 ， 你 将 
添加 所 有 数据 的 汇总 视图 。 为 了 进行 汇总 , 你 要 把 每 个 月 锻炼 的 距离 累加 起 来 。 客 户 端 的 汇总 数 
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据 也 将 进行 响应 性 更 新 。 当 新 的 文档 添加 到 锻炼 集合 ， 受 影响 月 份 的 数据 将 显示 更 新 后 的 总 和 。 








7.1.1 publish() 和 subscribe() 


发 布 和 订阅 总 是 成 对 出 现 。 虽 然 collection 通 常 在 服务 器 和 客户 端 上 都 有 声明 ， 但 发 布 只 
存在 于 服务 器 上 。 它 们 像 模 板 辅助 函数 那样 ， 使 用 collection.find() 函数 从 数据 库 中 检索 数 
据 。 在 图 7-2 中 ， 你 可 以 看 到 一 个 示例 ， 发 布 从 数据 库 中 检索 三 个 文档 。 然 后 这 些 文档 用 和 集合 
相同 的 名 字 workouts 进 行 发 布 。 

发 布 订阅 


Meteor.subscribe('workouts'); | 



































Meteor.publish('workouts', function () { 
PoetuEn Lol loc ion TInt tiimLit > 2 














Pesrennnecranas nner ni sie 














把 文档 放 进 


| 
| 1 
1 发 布 workouts | 
1 ! workouts 


| 数据 


SSE NS 





SUSE OTE ULE 
pp re ef Fe ee ee 


集合 : 服务 器 和 客户 端 相同 


Collection = new Mongo.Collection('workouts'); 











图 7-2 ”发 布 和 订阅 概述 


客户 端 上 的 Meteor .subscribe() 调 用 发 起 一 个 到 服务 器 的 请 求 ,要求 发 送 workouts 和 集合 
的 数据 。 请 注意 ， 它 不 是 请 求 数 据 库 中 的 内 容 ， 而 是 服务 器 上 的 内 容 ， 更 确切 地 说 ， 是 
Collection.find() 的 结果 。 在 这 种 情况 下 ， 其 结果 只 是 三 个 文档 。 客 户 端 接收 这 些 文档 并 将 
其 放 和 人 同名 的 本 地 集合 中 。 虽 然 collection 对 象 在 服务 器 和 客户 端 上 都 有 相同 的 名 称 ， 但 它们 
可 能 会 包含 不 同 的 数据 ， 这 取决 于 上 下 文 和 发 布 的 设置 。 

1. 删除 autopublish 

为 要 手动 决定 发 送 给 客户 端的 内 容 , 所 以 你 必须 删除 autopublish 包 。Meteor 通 过 命令 行 
工具 来 添加 和 删除 包 。 删 除 autopublish 包 的 方法 如 下 : 

$ meteor remove autopublish 

一 旦 这 个 包 被 删除 ，Meteor 服 务 器 启动 后 ， 客 户 端 将 不 会 有 可 用 的 数据 了 。 即 使 客户 端 仍然 
知道 服务 器 上 所 有 可 用 的 集合 ,但 已 经 没有 数据 会 从 服务 器 端 MongoDB 发 送 到 浏览 器 的 
Minimongo 实 例 。 查 询 任何 集合 的 文档 都 不 会 得 到 什么 结果 。 
















































































134 第 7 章 数据 交换 





2. 设置 发 布 

为 了 显示 MongoDB workouts 集 合 中 需要 的 数据 ,你 必须 提供 一 个 发 布 /订阅 (pub/sub ) 对 。 
首先 ， 建立 一 个 简单 的 发 布 , 将 所 有 的 锻炼 文档 发 送 给 订阅 该 发 布 的 所 有 客户 端 。 因 为 所 有 的 发 
布 都 运行 在 服务 絮 范 围 内 ， 所 以 你 需要 将 把 它们 放 在 server 文 件 夹 下 一 个 新 的 publications.js 文 件 
中 。 下面 的 代码 清单 显示 了 如 何 设置 发 布 。 


代码 清单 7-1 一 个 简单 的 服务 咒 端 发 布 














命名 一 个 发 布 ， 以 方便 订阅 它 ， 
后 面 你 会 看 到 这 一 点 
< 一 一 





Meteor.publish('workouts', function () { 
return WorkoutsCollection.fingd({}); | 


发 布 可 以 返回 数据 ， 就 像 模板 
辅助 函数 那样 


中 站 


说 明 发 布 是 单 向 的 ， 它 将 数据 从 服务 器 发 送 到 客户 端 。 要 将 数据 从 客户 端 发 送 回 服务 器 ， 必 
须 提供 一 个 插入 和 更 新 数据 的 安全 方法 。 我们 将 在 本 章 后 面 讨论 这 个 话题 。 


这 个 时 候 ， 设 置 一 个 发 布 不 会 对 客户 端 产 生 任何 影响 。 客 户 端 必须 通过 订阅 来 要 求 数据 。 
7.1.2 全 局 订阅 
你 必须 在 客户 端 添 加 订阅 。 在 workoutTracker.js 文 件 的 顶部 ， 添 加 下 面 的 代码 : 


Meteor.subscribe ("workouts"); 

一 旦 订阅 了 发 布 , 你 会 看 到 所 有 在 服务 器 端 MongoDB 上 可 用 的 数据 在 客户 端 上 的 Minimongo 
中 也 可 用 。 你 可 以 在 浏览 器 控制 台中 使 用 与 发 布 中 相同 的 代码 : 

WorkoutsCollection.find({}) 


调用 Meteor .supscripe() 将 返回 一 个 对 象 ， 该 对 象 有 stop () 和 ready () 方 法 。stop() 
可 用 于 终止 订阅 ， 如 果 服 务 器 已 将 发 布 标记 为 准备 就 绪 ， 那 么 reaqgy () 将 返回 true。 它 是 一 个 
响应 式 数据 源 ， 就 像 collection 或 session。 

以 上 基本 上 就 是 autopublish 包 免费 为 所 有 集合 提供 的 功能 。 接 下 来 ， 将 通过 限制 发 送 给 
客户 端的 文档 数量 来 控制 发 布 给 客户 端的 数据 。 






























































使 用 服务 器 作为 客户 端 

当 两 个 Meteor 服 务 器 进行 信息 交换 时 ， 从 技术 上 讲 ， 一 个 服务 器 将 成 为 另 一 个 服务 器 的 客 
户 端 。subscripbe() 方 法 只 在 客户 端 上 下 文中 使 用 ， 但 服务 器 有 一 种 方式 可 以 订阅 另 一 个 服 
务 器 上 的 数据 ， 即 使 用 分 布 式 数据 协议 (Distributed Data Protocol，DDP ) 连接 。 

可 以 使 用 DDP.connect () 连 接 到 另 一 个 服务 器 。 它 以 远程 服务 器 的 URL 作 为 唯一 的 参数 。 
一 旦 连接 成 功 ， 它 将 返回 一 个 对 象 ， 该 对 象 可 以 使 用 subscribe() (访问 已 发 布 的 数据 )、 
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call() (调用 方法 )、methods () (定义 客户 端 方法 ) 以 及 一 些 其 他 的 函数 。 

将 一 个 服务 器 连接 到 另 一 个 服务 器 并 作为 客户 端 ， 只 需要 三 行 代码 。 首先, 定义 服务 器 到 
服务 器 的 连接 ,这 将 建立 一 个 到 http://192.168.2.201:3000 的 连接 。 其 次 ,为 了 接收 发 布 的 数据 ， 
需要 声明 一 个 集合 ,这 时 它 不 仅 包含 一 个 名 称 参 数 , 也 包含 如 何 连 接 到 主 服务 器 ,因此 server2 
是 第 二 个 参数 。 最 后 ， 服 务 器 可 以 订阅 remoteData。 另 外 还 有 一 个 微小 的 变化 ， 因 为 需要 在 
远程 服务 器 而 不 是 本 地 的 Meteor 实 例 上 调用 subscribe() 方 法 : 


VAarvocryer2 = DDP On too 2 Ul 0D 
var RemoteCollection = new Mongo.Collection('remoteData', server2); 
server2.subscribe('remoteData'); 


7.1.3 ”模板 级 订阅 


使 用 Meteor .supscribe 函 数 来 订阅 是 贪 焚 的 。 无论 用 户 是 否 查 看 订阅 数据 , 这 个 函数 将 在 
服务 器 上 注册 一 个 订阅 ， 并 触发 数据 传输 。 只 要 用 户 点 击 应 用 的 首页 ， 所 有 的 订阅 将 会 被 制作 ， 
数据 将 会 被 加 载 ， 即 使 用 户 从 来 不 看 它 。 你 可 以 通过 将 它们 绑 定 到 模板 来 避免 这 种 全 局 订阅 , 也 
就 是 使 用 Meteor 的 模板 级 订阅 。 

使 用 模板 级 订阅 时 ， 创 建 模板 时 会 发 起 订阅 。 模 板 被 销毁 时 ， 订 阅 也 将 被 终止 。 这 样 ， 你 可 
以 限制 客户 端 和 服务 器 之 间 实 际 的 数据 传输 。 你 也 不 需要 担心 哪 条 路 由 "需要 哪些 数据 ; 你 可 以 
直接 将 此 关系 传递 给 需要 数据 的 模板 。 每 个 remplate 实 例 有 它 自 己 的 subscribe 函 数 ， 它 使 用 
和 Meteor .subscribe 相 同 的 语法 。 在 模板 的 oncreated 回 调 孔 数 中 ， 可 以 通过 this 来 访问 当 
前 的 模板 实例 : 












































Template.workoutList.onCreated(function () { 

this.subscribe ("workouts"); 
每 当 workoutList 模 板 创建 后 , Meteor 会 自动 设置 对 锻炼 发 布 数据 的 订阅 。 要 确定 订阅 是 否 
已 准备 好 ， 可 以 使 用 Template.subscriptionsReady 辅 助 函 数 。 如 果 一 个 模板 的 所 有 订阅 都 
准备 好 了 ， 它 会 返回 true。 它 可 以 用 于 显示 模板 本 身 的 加 载 指示 ， 如 下 面 的 代码 清单 所 示 。 


代码 清单 7-2 使 用 加 载 指示 的 模板 级 订阅 
































// workoutTracker.html 


<template name="workoutList"> 如 果 所 有 模板 订阅 
{{#if Template.subscriptionsReady}} < 一 准备 就 绪 , 则 返回 真 
<ul> 
{{#each workouts}} | 显示 锻炼 
<l1i>{{workoutAt}}</1i> | 的 细节 
{{/each}} 
I 

















中 我 们 将 在 下 一 章 讨论 基于 路 由 的 订阅 。 
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{{else}} | 让 用 户 知道 
loading workouts... < 一 | 数据 正在 被 
认证 直 寺 | 加 载 

</template> 


// workoutTracker.js 
Template.workoutList.onCreated (function 
this.subscribe('workouts'); 


} 0) 


Template.workoutList.helpers(t{ 


workouts: function () { 
return WorkoutsCollection.find({}, { 
sort: { 


workoutAt: -1 


入 
} 
这 





() { 


二 一 


| 设置 订阅 


Ev 


返回 所 有 的 锻炼 ， 
最 新 的 数据 在 前 面 





使 用 模板 级 订阅 可 以 让 你 更 好 地 控制 在 什么 时 间 什 么 地 点 加 载 数 据 。 通 过 避免 全 局 订阅 , 你 


也 减少 了 在 最 初 加 载 Meteor 应 用 时 所 需 的 流量 。 特 

















别 是 当 你 在 同一 个 页 面 上 泻 染 多 个 模板 时 ,， 没 





有 必要 等 到 所 有 的 数据 都 可 用 ， 每 个 模板 可 以 使 用 自己 的 加 载 指示 需 。 
在 本 章 的 剩余 部 分 , 我 们 将 使 用 全 局 的 Meteor .subscribe, 因为 这 样 例 子 会 很 简单 。 对 于 
更 复杂 的 应 用 , 你 可 以 使 用 相同 的 语法 , 并 将 订阅 放 在 模板 的 oncreated 回 调 函数 中 。 它 们 的 行 








为 完全 一 样 ， 除 了 生存 时 间 以 外 。 











7.1.4 参数 化 订阅 








口 Meteor .subscribe 在 客户 端 加 载 应 用 时 建立 ， 并 在 客户 端 关闭 连接 时 终止 。 
口 Template. subscribe 在 关联 的 模板 创建 时 建立 ， 并 在 模板 被 销毁 时 终止 。 





因为 性 能 的 原因 ,你 不 希望 让 整个 数据 库 的 内 容 在 网 上 传输 。 除 了 要 花 很 长 的 时 间 来 传输 以 














外 , 太 多 的 信息 可 能 会 让 用 户 觉得 困惑 。 因 此 ,最 初 只 需 发 布 workouts 集 合 中 10 个 最 新 的 文档 。 








如 果 用 户 想 看 到 更 老 的 记录 ， 他 们 可 以 选择 要 求 更 多 的 文档 。 显 然 ， 现 有 的 发 布 代码 需要 调整 。 


它 必 须 支 持 以 下 限制 ， 即 用 一 个 参数 来 动态 地 确定 
我 们 一 步 一 步 来 看 。 











裔 移 ， 然 后 发 送 第 二 或 第 三 组 的 10 个 文档 。 让 


要 做 的 第 一 件 事 是 告诉 发 布 你 要 对 锻炼 查询 所 做 的 限制 。 你 可 以 在 订阅 调用 中 添加 参数 ,而 
这 个 参数 将 作为 服务 器 发 布 函数 中 的 参数 。 这样, 你 可 以 为 发 布设 置 选 项 ,客户 端 会 告诉 服务 带 





要 做 什么 。 





警告 无 论 何 时 ， 处 理 来 自 客户 端的 数据 时 ， 你 必须 在 使 用 它 之 前 进行 验证 。 


该 发 布 需要 一 个 opt ions 人 参数 ,这 个 参数 首先 需要 进行 检查 。 你 可 以 使 用 Meteor 的 check () 


函数 ， 无 需 诡 加 自己 的 验证 函数 。 
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1. 通过 check () 来 验证 数据 
通过 使 用 check () 函数 ,可 以 根据 已 知 的 模式 来 匹配 输入 值 。 要 限制 订阅 ,你 期 望 用 户 提供 
个 数字 ， 而 不 是 任何 其 他 的 东西 。check () 使 用 一 个 简单 的 语法 ， 它 带 有 两 个 参数 ， 即 值 本 身 
和 这 个 值 需要 匹配 的 模式 : 


check(value, pattern); 


要 确保 所 提供 的 参数 只 包含 一 个 数 ， 可 在 发 布 中 使 用 check (options，Number) 。 在 我 们 
的 示例 中 ， 你 正在 处 理 一 个 对 象 ， 所 以 必须 检查 对 象 的 每 个 参数 的 模式 。 
check (options, 
{ 
limit: Number 


j 


当 我 们 讨论 方法 时 ， 你 也 将 会 使 用 check ()。 

2. 动态 订阅 

代码 清单 7-3 显 示 了 服务 器 上 publications.js 文 件 中 的 代码 。 
代码 清单 7-3 ”为 发 布 添加 参数 


Meteor.publish('workouts', function(options)t{ | 该 发 布 以 一 个 选项 
































check (options, (option) 对 象 作为 


{ 
参 
limit: Number 参数 


} 





i 按时 间 对 所 有 
数据 库 条 目 进 

var qry = {}; 行 排序 ， 以 确 
var qryOptions = { 保 限制 从 最 新 

limit: options.limit, = A 

sort: {workoutAt: 1} < 的 实 崩 开始 使 用 MongoDB 的 限制 
) (limit) 查询 选项 ， 只 返 

回 有 限 数量 的 文档 

return WorkoutsCollection.find(gqry, qryOptions); 


}); 

现在 每 个 客户 端 都 可 以 订阅 该 发 布 并 设置 一 个 限制 。check () 函数 期 望 一 个 选项 ( option ) 
对 象 作为 参数 。 如 果 该 参数 不 是 订阅 传递 过 来 的 ，check () 函数 将 抛 出 一 个 错误 。 你 必须 为 客户 
创建 一 个 订阅 ,用 以 订阅 这 个 发 布 提供 的 数据 。 因 为 订阅 仅 在 浏览 器 中 可 用 ,所 以 可 以 在 客户 端 
文件 夹 下 的 workouttrackerjs 文 件 中 做 这 件 事 。 你 将 使 用 Session 来 跟踪 当前 使 用 的 限制 ( 见 下 面 
的 代码 清单 )。 


代码 清单 7-4 ”使 用 参数 订阅 发 布 











、 a | 订阅 的 限制 参数 ， 使 
Session.setDefault('limit', 10); 二 一 -| 用 一 个 默认 值 为 10 


的 Session 变 量 
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// Subscriptions 


Tracker .autorun (function(computation){ autorun 创 建 了 一 个 响应 
Meteor.subscribe('workouts', { 性 上 下 文 , 如 果 限 制 改变 
limit: Session.get ('limit') < 它 将 更 新 订阅 
ji 
}); 会 话 对 象 中 的 限制 
值 被 传递 





当 应 用 第 一 次 启动 时 ， 因 为 Session 变 量 1imit 没 有 其 他 的 值 ， 所 以 被 设 为 10。 这 是 set- 
Default 实 现 的 ， 它 确保 1imit 永 远 有 一 个 值 。 

需要 把 订阅 放 在 Tracker .autorun 中 的 原因 是 创建 一 个 响应 性 上 下 文 。 一 旦 Session 变 量 
limit 更 改 , 订阅 workouts 会 使 用 更 新 后 的 1imit 值 重新 运行 。 这 意味 着 每 当 1imit 值 发 生变 化 
时 由 事件 或 直接 从 JavaScript 控 制 台 触发 , 订阅 会 自动 更 新 。 然后 新 的 发 布 数 据 将 会 被 添加 到 
客户 端的 Minimongo， 最 终 在 模板 上 进行 泻 染 。 

为 了 有 更 方便 的 方法 来 增加 显示 文档 的 数量 ， 可 以 添加 一 个 按钮 和 一 个 单 击 处 理 程序 ， 将 
session 对 象 中 的 1imit 值 增加 10 ( 见 下 面 的 代码 清单 )。 


代码 清单 7-5 ”添加 一 个 事件 处 理 程序 来 将 1imit 的 值 增加 10 


Template.workoutList.events({ 
'click putton.show-more': function(evt, tpl)t{ 









































var newLimit = Session.get ('limit') + 10; 修改 响应 式 会 话 变量 
Session.set('limit', newLimit); 中 的 limit， 将 会 自动 
) | 更 新 订阅 


正如 你 所 看 到 的 ， 删 除 autopuplish 包 ， 自 己 来 控制 客户 端 上 可 用 的 数据 并 不 是 太 难 。 使 
用 响应 式 变量 ,修改 订阅 和 可 用 的 数据 也 很 容易 。 用 于 限制 文档 数量 的 方法 ,也 能 方便 地 用 于 过 
滤 和 排序 。 在 进入 下 一 个 部 分 之 前 ， 请 尝试 添加 第 二 个 按钮 ， 它 提供 -1 或 1 来 对 所 有 的 文档 进行 
升序 或 降序 排序 。 


7.1.5 向 客户 端 独 有 的 集合 发 布 汇总 数据 


想象 你 一 周 跑步 三 次 ， 一 个 月 四 周 。 你 的 身体 非常 健康 ， 但 你 也 需要 看 看 这 一 个 月 内 的 12 
条 不 同 的 记录 ,以 了 解 你 在 这 个 月 内 跑 了 多 少 英 里 。 这 样 的 快速 统计 比较 痛 苗 。 而 这 就 是 使 用 数 
据 聚 合 的 时 候 。 有 时 需要 对 大 量 的 数据 进行 汇总 而 不 是 显示 所 有 的 细节 , 以 使 这 些 数据 更 有 意义 。 
让 我 们 来 扩展 这 个 应 用 以 便 你 可 以 肯定 地 说 ， 你 在 六 月 跑 得 比 一 月 更 远 。 

如 果 所 有 的 锻炼 文档 都 在 客户 端 上 , 聚合 可 能 是 一 个 很 容易 的 任务 。 通 过 遍历 每 个 月 的 每 个 
文档 ， 累 加 其 中 的 距离 就 可 以 了 。 不 幸 的 是 ,这 种 方法 有 很 多 缺点 。 其 一 是 必须 在 网 络 上 传输 大 
量 的 数据 。 如 果 想 聚合 过 去 10 年 的 数据 ， 你 将 会 在 网 络 上 发 送 成 千 上 万 的 文档 。 另 一 个 缺点 是 ， 
这 个 计算 需要 相当 长 的 一 段 时 间 ， 这 将 让 用 户 的 界面 响应 缓慢 ， 导 致 用 户 体验 不 佳 。 因 此 ， 你 需 
要 在 服务 器 上 聚合 数据 并 发 布 它们 。 图 7-3 显 示 客 户 端 订 阅 了 两 个 发 布 。 其 中 workouts 使 用 了 
find() 方 法 ， distanceByMonth 将 使 用 MongoDB 的 聚合 框架 。 
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| SE 订阅 workouts | 
| 区 本 
| | i 
[5 E> 
| Qistance 
1 aggregate () ] >! | distance 
! 2 PM 1 订阅 GistanceByMonth | ByMonth 
A 服务 器 人/ 
一 个 集合 两 个 发 布 
图 7-3 ”在 单个 数据 库 集合 中 使 用 两 个 发 布 
MongoDB 的 数据 聚合 








如 果 熟 悉 SQL， 你 可 能 已 经 想 做 一 个 SELECT， 在 其 中 使 用 COUNT (*) 和 GROUP BY， 但 这 
不 能 在 NoSQL 的 世界 中 工作 。MongoDB 本 身 是 创建 用 于 处 理 和 分 析 大 型 数据 集 的 ， 所 以 它 也 
提供 了 一 种 方式 来 聚合 数据 ， 而 不 是 使 用 GROUP BY。 你 将 使 用 聚合 管道 (aggregation pipeline ) 
来 比较 一 年 中 所 有 月 份 的 距离 。 在 浏览 器 中 实现 的 Minimongo 客 户 端 不 支持 使 用 聚合 管道 ， 但 
你 会 看 到 这 不 是 问题 。 

将 要 采用 的 方法 是 创建 一 个 发 布 , 但 是 该 发 布 不 直接 发 送 集合 (Collection ) 中 的 数据 ， 
而 是 在 集合 中 聚合 数据 , 然后 把 聚合 数据 返回 给 所 有 的 订阅 者 。 存储 聚合 数据 的 集合 只 存在 于 
客户 端 。 它 没有 在 服务 器 端的 MongoDB 中 保存 ， 因 为 它 会 产生 数据 宛 余 。 

首先 ， 创 建 一 个 名 为 distanceByMonth 的 发 布 。 但 它 在 数据 库 中 没有 相应 的 集合 。 你 以 
前 在 数据 库 集 合 上 放 finad() 操作 的 地 方 ， 也 就 是 publish () 的 第 二 个 参数 ， 现 在 将 是 一 个 聚 
合 操 作 。 

Meteor 本 身 不 带 有 MongoDB 的 聚合 框架 支持 。 但 有 几 个 社区 包 可 提供 聚合 能 力 ， 所 以 你 
自己 可 以 很 容易 地 添加 它 。 你 将 回 退 到 MongoDB 的 内 核 驱 动 ， 然 后 定义 实际 的 管道 ， 
合 ， 这 样 它 就 不 会 阻塞 任何 其 他 过 程 ， 最 后 标记 订阅 为 ready。 


> 





I 
见 





任何 发 布 都 可 以 向 其 订阅 者 发 送 状 态 消息 ， 用 以 表明 内 容 已 更 改 或 所 有 可 上 月 
送 。 直 接 发 布 数据 库 集合 时 ， 这 些 状态 消息 将 由 Meteor 自 动 管 弄 
地 调用 它们 。 
口 added (collection,docId,fields) 当 一 个 新 文档 被 创建 时 ， 第 一 个 参数 是 集 


的 内 容 都 已 发 
E。 使 用 自 定义 发 布 时 ， 必须 显 式 





























全 
口 


和 


» 


后 是 文档 编号 (ID )。 第 三 个 参数 包含 文档 
D changed (collecton,docId,fields) 月 
为 第 一 、 二 个 参数 传递 ， 然 后 是 一 个 对 象 ， 





的 所 有 字段 (不 包括 _id 字 段 )。 
月 于 更 改 的 文档 ， 再 次 将 集合 名 称 和 文档 ID 作 
它 包 含 所 有 更 新 过 的 字段 (具有 undaefineq 
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值 的 字段 已 从 文档 中 删除 )。 

口 removed (collection,docId) 它 需 要 两 个 参数 : 要 删除 的 集合 名 称 和 文档 ID。 
口 ready () 它 不 需要 参数 ， 用 于 通知 客户 端 所 有 可 用 的 数据 已 被 发 送 。 

代码 清单 7-6 给 出 了 完整 的 代码 ， 我 们 将 一 点 一 点 来 看 。 要 使 用 MongoDB 的 核心 驱动 ， 必 须 
使 用 MongoInternals, 这 是 mongo 包 的 一 部 分 , 而 nongo 包 会 包含 在 每 个 新 建 的 Meteor 项 目 中 。 
Meteor 使 用 的 默认 数据 库 引 用 存储 在 ab 中 。 因 为 你 在 使 用 MongoDB 的 核心 驱动 程序 ， 所 以 可 以 
使 用 所 有 的 函数 ,包括 aggregate() 。pipeline 变 量 包 含 一 个 数组 ， 其 内 容 为 实际 聚合 的 详细 
信息 。MongoDB 的 聚合 管道 分 为 几 个 阶段 。 文 档 通过 管道 的 每 个 阶段 都 会 被 转换 。 首 先 ， 所 有 
匹配 文档 被 确定 。 在 这 种 情况 下 , 所 有 的 文档 都 会 匹配 ,因为 我 们 还 没有 定义 任何 限制 。 接 下 来 ， 
所 有 的 结果 文档 , 或 者 更 确切 地 说 是 给 定 的 字段 内 容 , 被 分 成 几 组 , 所 有 的 锻炼 将 按 月 进行 分 组 ， 
并 给 出 一 个 新 的 _ia 来 表示 月 份 (1= 一 月 、2 = 二 月 ， 等 等 )。 

MongoDB 本 身 不 是 响应 式 的 ， 调 用 它 会 导致 一 个 同步 调用 ， 这 将 阻塞 所 有 其 他 的 服务 器 请 
求 ,， 直到 聚合 完毕 。 这 就 是 为 什么 在 维护 完整 的 Meteor 上 下 文 时 ， 你 需要 一 个 方法 来 解除 聚合 的 
阻 寨 ,， 并 在 其 结束 以 后 接受 一 个 回调 函数 。 异 步调 用 外 部 组 件 应 始终 包 在 Meteor .bingd- 


Environment () 内 部 。 





















































说 明 这 种 聚合 操作 动态 地 完成 ， 这 意味 着 每 个 订阅 将 触发 数据 库 内 容 的 聚合 。 如 果 注 意 到 这 
个 处 理 需 要 很 长 时 间 ， 那 么 将 汇总 数据 写 入 到 专用 的 集合 可 能 是 一 个 更 好 的 选择 。 


使 用 Underscore 库 , 将 所 有 月 份 的 结果 添加 到 订阅 aistanceByMonth 中 。 最后, publish () 
函数 通知 客户 端 ， 订 阅 已 经 准备 就 绪 。 


代码 清单 7-6 ”发 布 内 部 的 聚合 
因为 聚合 没有 Meteor 官 方 的 


Meteor.publish('distanceByMonth', function(){ 支持 ， 所 以 需要 使 用 Mongo 
var subscription = this; 的 核心 驱动 
var db = MongoInternals.defaultRemoteCollectionDriver() .mongo.db; 4 
var pipeline = [ 2 


{ 
Sgroup: { 
_id: { Smonth: 'S$workoutAt' }, 
distance: { S$sum: 'S$Sdistance' } 
} 
} 
I 


聚合 设置 会 创建 文档 , 文档 的 _id 
字段 与 workoutAt 字 段 的 月 份 相 
等 ， 距 离 为 当月 所 有 距离 的 总 和 





| 创建 聚合 


db.collection('workouts') .aggregate( < 
Dipeline， 
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Meteor.bindEnvironment ( 


pt emer sn “| 因为 不 能 在 发 布 中 使 用 异步 代 
console.log('result', result); 码 ， 所 以 需要 使 用 
_.each(result, function(r)t{ meteor.bindEnvironment 

subscription.added('distanceByMonth', r._id, {distance: 
r.distance}); < 一 
}) 将 数据 添加 
} 到 这 个 订阅 
) 
订阅 已 准备 好 
subscription.ready (); 将 数据 发 送 给 
)); | 客户 端 








在 客户 端 ， 你 只 在 需要 此 数据 的 客户 端 上 创建 一 个 可 用 的 集合 。 在 客户 端 文件 夹 下 的 
workouttrackerjs 文 件 中 创建 这 个 集合 : 








DistanceByMonth = new Mongo.Collection('distanceByMonth'); 

这 看 起 来 和 其 他 任何 集合 的 行为 完全 一 样 , 但 是 数据 来 自 你 自 定义 的 发 布 而 不 是 服务 器 端的 
MongoDB。 你 可 以 像 通常 那样 使 用 这 个 集合 内 的 数据 。 你 可 以 创建 新 的 模板 和 辅助 函数 来 显示 
聚合 发 布 中 的 数据 。 更 多 的 细节 可 参考 示例 代码 。 

这 种 方法 的 一 个 缺点 是 ,这 个 数据 不 是 响应 式 的 ,因为 聚合 框架 只 是 个 哑 的 数据 源 。 这 意 
着 如 果 有 人 在 四 月 添加 了 一 个 8 英里 的 新 的 锻炼 记录 , 客户 端 四 月 的 汇总 数据 不 会 自动 增加 8。 当 
页 面 重新 加 载 时 ,订阅 将 被 重新 初始 化 ,使 得 屏幕 正确 地 更 新 。 这 绝对 不 是 Meteor 应 用 的 合理 行 
为 ，Meteor 应 用 内 的 客户 端 应 该 是 响应 式 的 。 下 一 步 ， 你 将 会 看 到 如 何 改进 这 个 聚合 发 布 ， 使 它 
也 具有 响应 性 。 


7.1.6 将 聚合 发 布 变 成 响应 式 数据 源 


聚合 发 布 不 是 响应 式 的 ， 不 像 通常 的 collection.find() 那 样 。 然 而 ， 你 希望 客户 端的 汇 
总 数据 在 数据 更 改 时 能 够 响应 性 更 新 , 就 像 增加 锻炼 数据 会 自动 更 新 列表 那样 。 要 将 聚合 变 成 一 
个 响应 式 的 数据 源 , 缺少 的 是 一 个 观察 者 , 它 将 监控 锻炼 集合 ,并 在 添加 新 的 锻炼 记录 时 执行 一 
个 动作 。 

每 个 集合 的 游标 ， 比 如 调用 workoutscollection.findq() 返 回 的 游标 ， 都 能 够 在 集合 内 
观察 那些 添加 、 删 除 或 更 改 的 文档 。 哪 些 文档 被 观察 将 取决 于 collection.find() 方 法 中 所 使 
用 的 查询 。 

通过 限制 某 个 fina () 的 查询 ,你 可 以 只 关注 jogging 类 型 的 锻炼 。 如 果 一 个 新 文档 被 添加 、 
更 改 或 删除 , 应 用 将 会 作出 响应 。 在 今后 某 个 时 候 , 我 们 可 以 添加 不 同 运动 类 型 的 锻炼 , 如 chess 
或 aerobics。 用 于 监视 数据 源 更 新 的 困 数 是 observechanges () 。 

有 三 种 情况 你 可 以 进行 观察 ,每 种 情况 都 有 相关 的 回调 函数 , 带 有 一 个 或 多 个 属性 。 这 里 的 
回调 函数 类 似 于 那些 用 于 设置 发 布 状 态 的 回调 函数 ， 但 是 它们 不 需要 集合 名 参数 。 

D added (docId, fields) 创建 一 个 新 文档 时 , 第 一 个 参数 是 文档 编号 , 第 二 个 参数 包 
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含 文档 的 所 有 字段 (不 包括 _ig 字 上 段 )。 
口 changed (docIq, fields) 一 一 用 于 更 改 的 文档 ，ID 依 然 作为 第 一 个 参数 ， 第 二 个 参数 
只 包含 更 新 的 字段 ( 值 为 undefinegd 的 字段 已 从 文档 中 删除 )。 
口 removed (docId) 一 一 它 需 要 一 个 参数 ， 从 集合 中 删除 的 文档 的 ID。 














说 明 虽然 有 相同 的 名 字 ， 但 发 布 中 的 添加 、 更 改 和 删除 函数 使 用 的 语法 稍 有 不 同 。 


下 面 的 代码 清单 显示 了 它们 的 语法 ， 在 一 个 监视 Workoutscollection 的 查询 中 ， 三 个 回 
调 函 数 都 被 使 用 到 了 。 


代码 清单 7-7 观察 集合 中 的 变化 
WorkoutsCollection 
.find( query ) 
.ObserveChanges ({ 
added: function(id, fields){ 
// 在 查询 中 添加 一 个 文档 时 做 一 些 事情 
和 
changed: function(id, fields){ 
/ /查询 中 的 某 个 文档 被 修改 时 做 一 些 事情 
ks 
removed: function(id) { 
/ /查询 中 的 某 个 文档 被 删除 时 做 一 些 事情 
} 
让 ) 放 


你 知道 如 何在 发 布 中 聚合 数据 ,以 及 如 何在 集合 中 添加 文档 时 创建 回调 函数 。 这 就 是 让 一 个 
聚合 发 布 具有 响应 性 需要 的 所 有 技术 。 其 技巧 是 在 发 布 中 创建 一 个 对 象 ， 该 对 象 通过 observe- 
changes () 来 跟踪 所 有 的 汇总 数据 。 在 这 个 例子 中 ，workoutHandle 用 于 监视 集合 并 观察 是 否 
有 新 的 文档 被 添加 。 如 果 有 新 文档 , 你 可 以 在 跟踪 汇总 数据 的 对 象 中 更 新 该 月 的 总 距离 。 然 后 最 
近 更 新 的 数据 被 发 送 到 客户 端 ， 告 诉 它 订 阅 已 被 更 改 ( 参见 下 面 的 代码 清单 )。 


代码 清单 7-8 使 用 observechanges 来 更 新 汇总 数据 



























































Meteor.publish('distanceByMonth', function () { 你 需要 这 个 ， 因为 最 初 订 
var subscription = this; 阅 的 第 一 个 文档 不 应 该 影 
var initiated = false; < 响 添加 的 回调 函数 
Var distances = {}; 二 三 一 一 
这 个 对 象 跟 
// existing aggregation code 踪 每 个 月 的 
re 
var workoutHandle = WorkoutsCollection ee 创建 文档 
.find() 的 ID。+1 
.observeChanges ({ 是 因为 月 
added: function (id, fields) { 份 的 索引 
if (!initiated) return; 从 0 开始 


idByMonth = new Date(fields.workoutAt) .getMonth() + 1; < 一 
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| | 如 果 有 新 的 锻炼 记录 添加 ， 
distances[idByMonth] += fields.distance; < | 更 新 这 个 月 的 距离 
subscription.changed('distanceByMonth', | 


idByMonth, { 通知 客户 端 订阅 内 
distance: distances[idByMonth] 容 已 更 改 


} 
) 
} 
})3 


subscription.ready (); 
}); 
现在 ， 每 当 一 个 新 的 锻炼 被 添加 到 workouts 时 ， 跟 踪 汇 总 数据 的 对 象 (workoutHandle ) 
会 被 更 新 , 并 且 更 新 会 被 发 送 到 客户 端 。 回 到 你 的 浏览 器 ,通过 控制 台 添 加 一 个 新 的 锻炼 。 你 将 
看 到 相应 汇总 数据 的 更 新 。 

最 后 但 很 重要 的 一 件 事 是 , 清理 发 布 。 如 果 你 不 停止 观察 方法 ,它们 会 不 断 运 行 。 停 止 集合 
观察 的 正确 时 机 是 客户 端 订阅 停止 的 时 候 。 





























订阅 有 一 个 onStop 回 
调 函 数 ， 在 客户 端 订 





i 阅 关闭 时 会 被 调用 
subscription.onStop(function(){ < 

workoutHandle.stop(); observerChanges() 函 

了 数 返 回 的 句柄 (handle) 





用 来 停止 观察 


说 明 如 果 想 发 布 单个 文档 ， 你 仍然 需要 使 用 collection.find({_id: options._id}) 而 
不 是 findone ()。 这 是 因为 发 布 必 须 返 回 一 个 游标 ， 而 findone () 将 返回 实际 结果 。 





当 客 户 端 停止 订阅 时 ， 观 察 将 被 停止 。 


7.1.7 通过 用 户 ID 限制 数据 可 见 性 

你 现在 可 以 控制 发 送 给 客户 端的 数据 ， 确 保 不 是 每 个 锻炼 数据 都 会 被 发 送 。 不 过 ， 你 还 需要 
一 种 方法 来 决定 某 个 用 户 可 以 看 到 多 少 文档 ,他 只 能 看 到 自己 的 锻炼 记录 , 而 不 是 其 他 用 户 的 ( 见 
代码 清单 7-9 )。 为 此 ， 你 将 添加 本 章 前 面 提 到 的 账户 〈accounts ) 包 。 在 一 个 发 布 路 ， 你 可 以 使 
用 this.userId 来 访问 当前 登录 用 户 的 userIQ， 如 果 用 户 未 登录 ， 它 的 值 则 为 空 。 











代码 清单 7-9 只 发 送 允 许 用 户 看 到 的 数据 
Meteor.publish('workouts', function (options) { 
check (options, { 
limit: Number, 
sorting: Number 
}); 
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Var gry “Ss. { 

userId: this.userIQ < 一 查询 属于 当前 登 
了 录用 户 的 所 有 锻 
Var gqryOptions = { 

limit: options.1limit, 炼 数 据 

sort: { 


WworkoutAt: options.sorting 


} 


return WorkoutsCollection.find(gqry, qdqryOptions); 
3 








重要 的 是 要 将 用 户 信息 存储 在 锻炼 文档 中 。 如 果 这 样 做 的 话 , 只 需 在 workoutscollection 
fingd (qry ...) 隐 数 的 查询 中 简单 地 添加 { userId: this.userIa } 就 可 以 了 。 男 外 请 注意 ， 





如 果 你 登录 或 登 出 ， 数 据 会 响应 式 更 新 。 





聚合 的 数据 则 需要 稍微 复杂 一 些 的 调整 ,因为 你 需要 匹配 聚合 本 身 和 需要 观察 的 查询 ( 参见 


下 面 的 代码 清单 )。 
代码 清单 7-10 ”一 个 用 户 文档 的 聚合 


Meteor.publish('distanceByMonth', function () { 
var subscription = this; 
var initiated = false; 
var distances = {}; 
Var userId = this.userId; 
var db = MongoInternals.defaultRemoteCollectionDriver() .mongo.db; 





Var pipeline = [{ 
smatch: { 
userIid: userId < 聚合 应 该 只 发 生 在 
与 userld 匹 配 的 文 
ee 档 上 
Sgroup: { 
二 


smonth: 'SworkoutAtL 
党 
distance: { 

$sum: 'S$distance' 


a 


db.collection('workouts') .aggregatel 
pipeline, 
Meteor.bindEnvironment ( 
function (err, result) { 
console.log('result', result); 
_.each(result, function (r) { 
distances[r._id] = r.distance; 
subscription.added('distanceByMonth', r._id, { 
distance: r.distance 


}) 
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var workoutHandle = WorkoutsCollection 


.find({ 
userId: userId = 在 这 个 发 布 中 ， 只 有 匹 
2 配 登 录用 户 userld 的 文 
.ObserveChanges ({ 档 会 被 观察 
added: function (id, fields) { 2 
if (!initiated) return; 


idByMonth = new Date(fields.workoutAt) .getMonth() + 1; 
distances[idByMonth] += fields.distance; 


subscription.changed('distanceByMonth', 
idByMonth, { 
distance: distances[idByMonth] 
} 
) 
} 
}); 


initiated = true; 
subscription.onStop(function () { 
workoutHandle.stop(); 
}); 
subscription.ready (); 
}); 


要 更 新 聚合 发 布 , 使 它 只 依赖 于 某 个 用 户 , 不 需要 做 很 多 事情 。 只 需要 汇总 具有 正确 userId 
的 文档 。 最 后 ， 应 该 观察 的 文档 必须 是 查询 {userId: this.userId} 的 结果 。 











7.2 ”Meteor 的 方法 


Meteor 使 得 从 客户 端 发 送 数据 到 服务 器 很 容易 。 但 在 Web 上 ， 你 永远 不 要 相信 来 自 客 户 端的 
数据 。 你 永远 不 能 肯定 是 不 是 有 一 个 恶意 黑客 在 男 一 端 试 图 访问 或 修改 敏感 数据 。 因 此 , 来 自 客 
户 端 的 一 切 数据 都 必须 在 处 理 之 前 进行 验证 。 使 用 浏览 右 的 控制 台 ， 每 个 验证 都 可 以 被 绕 过 。 这 
适用 于 所 有 的 Web 应 用 ， 不 管 它们 是 用 Java 还 是 JavaScript 写 的 。 

解决 方案 是 在 服务 器 端 处 理 所 有 写 操作 时 实现 一 个 安全 保护 。Meteor 使 用 了 一 个 类 似 于 远 
程 过 程 调用 ( remote procedure call，RPC ) 的 概念 ， 它 可 以 从 客户 端 调 用 ， 先 在 客户 端 执 行 ， 然 
后 再 在 服务 器 端 执 行 。 它 们 被 称 为 方法 (method )， 不 仅 有 助 于 让 应 用 更 加 安全 ， 也 能 够 使 用 延 
述 补偿 让 应 用 对 用 户 更 加 友好 。 

把 数据 存储 到 数据 库 中 需要 相对 较 长 的 时 间 ， 它 取决 于 网 络 连接 和 写 和 的 速度 。 图 7-4 说 明 
了 如 何 使 用 方法 来 提高 安全 性 和 写 操 作 的 感知 速度 。 首先， 用户 提交 一 个 新 的 锻炼 。 事 件 处 理 程 
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序 接收 数据 并 将 其 传递 给 客户 端 方法 。 此 方法 将 执行 数据 验证 ， 以 检查 输入 的 距离 是 否 有 效 。 如 
果 所 有 检查 都 通过 了 ， 它 将 模拟 数据 库存 储 过 程 ， 即 将 数据 添加 到 本 地 的 Minimongo 实 例 并 更 新 
用 户 的 屏幕 。 这些 将 在 一 个 很 短 的 时 间 内 发 生 , 因为 所 有 的 事件 都 发 生 在 本 地 计算 机 或 移动 设备 
的 内 存 中 。 然 后 数据 被 发 送 到 服务 器 , 在 那里 将 执行 相同 的 方法 。 可 能 会 添加 一 些 服务 器 特定 的 
检查 ， 比 如 确保 用 户 ID 是 正确 的 。 如 果 所 有 的 验证 通过 ,数据 将 存储 在 数据 库 中 并 向 客户 端 确认 






































潜在 不 安全 的 内 容 
被 发 送 到 服务 器 





6. 验证 数据 7 2. 验证 数据 
RR 5. 调用 方法 存储 
锻炼 数据 













应 用 

















| Livequery | 8. 确认 成 功 
“i 


ph 
7. 存储 到 数据 库 
图 7-4 ”用 户 生 成 的 内 容 必 须 总 是 在 服务 器 上 进行 验证 ， 因 为 绕 过 在 客户 端 上 执行 的 验 

证 代码 是 可 能 的 

方法 不 仅 可 以 用 于 数据 库 操作 ,也 可 以 用 于 其 他 需要 在 服务 器 上 发 生 的 任何 事情 , 如 发 送 电 
子 邮件 或 触发 进程。 

在 本 节 中 ， 你 将 使 用 方法 蔡 换 默 认 的 insecure 包 ( 它 可 以 让 任何 人 访问 每 个 数据 库 文档 )， 
它 将 允许 细 粒 度 的 安全 控制 。 用 户 将 能 够 在 集合 中 添加 自己 的 锻炼 记录 。 为 此 ,你 将 使 用 一 个 方 
法 调用 发 送 写 操作 ， 而 不 是 直接 进行 插入 和 更 新 。 















































7.2.1 删除 insecure 包 


正如 autopuplish 功 能 是 以 包 的 形式 提供 一 样 , 有 个 名 为 jnsecure 的 包 人 允许 客户 端 向 服务 
器 端 数据 库 发 起 写 人 。 顾 名 思 义 ,， 它 的 目的 不 是 用 于 生产 环境 ， 而 是 要 加 快 开发 的 过 程 。 要 从 应 
用 中 删除 这 个 包 ， 请 停止 “Meteor 服 务 器 "” ， 并 发 出 以 下 命令 : 


$ meteor remove insecure 


在 浏览 絮 控 制 台 可 以 更 新 和 插入 数据 , 这 在 开发 过 程 中 是 很 有 用 的 , 所 以 是 在 开发 的 早期 阶 
段 删除 insecure 包 还 是 利用 它 的 功能 来 进行 快速 开发 将 取决 于 你 。 无 论 哪 种 方式 ， 生 产 环境 下 
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部 署 应 用 都 不 应 该 让 insecure 包 依然 有 效 。 
一 旦 insecure 包 被 有 删除， 服务器 重新 启动 后 ， 任 何 试 图 更 新 、 搬 和 人 或 从 客户 端 删 除 文档 的 
尝试 都 会 导致 错误 ， 控 制 台中 会 输出 错误 信息 (参见 图 7-5 )。 

















Q Elements Network Sources Timeline Profiles » 生火 思 ,x | 





© 可 <top frame> vY © Preserve log 
> Workouts.insert({type: ‘jogging', distance: 10}) 
¢ "VvZ4YSJ7x8nSjENEZi" 
insert failed: Access denied debug,js:41 





> 





图 7-5 当 insecure 包 被 删除 时 ， 在 浏览 器 中 的 任何 写 操作 都 会 被 拒绝 访问 


说 明 数据 的 读 取 访 问 由 发 布 定义 ， 所 以 删除 insecure 包 不 会 保护 任何 敏感 数据 。 它 只 是 禁止 
客户 端 直 接 写 入 服务 器 端的 数据 库 。 


7.2.2 ”使 用 方法 将 数据 写 入 集合 


在 哪里 使 用 方法 取决 于 你 想 做 什么 。 如果 把 一 个 方法 放 在 服务 器 文件 夹 中 , 你 仍然 可 以 从 客 
户 端 调用 它 ， 但 该 方法 只 会 在 服务 器 而 不 会 在 客户 端 上 执行。 如 果 该 方法 在 服务 器 和 客户 端 之 间 
共享 ， 则 该 过 程 类 似 于 collection.insert () 函数 。 这 意味 者 这 个 方法 调用 将 在 客户 端 上 立即 
执行 。 如 果 一 切 顺利 的 话 ， 它 也 会 在 服务 器 上 执行 ; 如 果 有 什么 问题 ,客户 端 会 返回 到 该 函数 调 
用 前 的 样子 。 这 样 ， 你 也 可 以 用 方法 来 获得 延迟 补偿 。 














提示 如 果 方 法 在 客户 端 上 执行 ， 它 将 是 一 个 模拟 执行 。 你 可 以 通过 在 方法 上 下 文中 使 用 


this. isSimulation() je 个 检查 ， 以 确定 该 代码 是 用 于 触发 远程 方法 还 是 只 作 
为 存根 运行 。 如 果 该 方法 在 客户 端 上 运行 ， 这 个 函数 将 返回 true， 模 拟 也 可 以 在 服务 
器 上 使 用 。 


现在 你 希望 用 户 能 够 通过 添加 一 个 简单 的 表单 自己 添加 锻炼 记录 。 如 果 表 单 提交 , 则 从 表单 
中 提取 数据 ， 然 后 用 这 个 数据 调用 方法 。 在 方法 调用 中 ， 要 确保 数据 是 有 效 的 ,并且 来 自己 登录 
的 用 户 一 一 客人 是 不 能 添加 锻炼 数据 的 。 最 后 ， 你 在 这 个 方法 中 创建 一 个 新 的 锻炼 记录 。 

Meteor .call() 需 要 一 个 强制 参数 : 方法 名 称 。 此 外 ， 你 可 以 无 限制 地 添加 其 他 需要 的 参 
数 , 它们 将 在 该 方法 中 可 用 。 你 提供 的 最 后 一 个 参数 是 一 个 回调 函数 , 用 来 处 理 方法 返回 的 结 
(参见 代码 清单 7-11 )。 回 调 本 身 需 要 两 个 参数 : error 和 result。 如 果 方 法 像 预期 那样 完成 ， 
error 的 值 将 保持 为 undefined。result 中 包含 方法 的 返回 值 ， 在 这 种 情况 下 ， 其 值 为 新 插入 
锻炼 文档 的 人 D。 
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代码 清单 7-11 从 客户 端 调用 方法 





Template.addWorkout .events ({ 表单 提交 的 默认 行 
'submit form': function (evt, tpl) { 为 应 该 被 阻止， 因为 使 用 
evt .preventDefault (); 一 已 将 重新 加 载 页 面 jQuery 从 
像 通常 一 距离 输入 
样 监听 表 框 中 抽取 
单 的 提交 var distance = parseInt (tpl.$('input[name="distance"]').val()); < 一 数据 并 将 
事件 其 转换 为 
| 该 方法 使 用 它 的 一 个 整数 
Meteor.call('CreateWorkout', { 名 称 和 附加 参数 
distance: distance 来 调用 
}, function (error, result) { 
if (error) return alert('Error: ' + error.error); < 二 一 
)) 1 该 方法 有 一 个 回调 函数 ， 如 
} 果 发 生 错 误 或 从 服务 器 返回 
ys 结果 ， 回 调 函数 将 会 被 调用 








方法 总 是 有 一 个 名 称 ,， 可 以 有 不 定数 目的 参数 。 这 样 ， 你 可 以 使 用 一 个 方法 将 数据 从 客户 端 
发 送 到 服务 器 。 下 一 步 ,你 必须 定义 这 个 方法 , 它 的 目的 是 创建 一 个 锻炼 文档 。 让 我 们 把 它 放 到 
方法 ( methods ) 文件 夹 下 的 一 个 新 文件 中 。 它 应 该 可 以 在 客户 端 和 服务 需 端 访问 ， 这 样 就 可 以 
利用 延迟 补偿 ( 见 下 面 的 代码 清单 )。 


代码 清单 7-12 使 用 一 个 方法 来 创建 新 文档 
创建 方法 遵循 辅助 函数 的 规 



































则 : 方法 函数 以 一 个 键 - 值 对 对 象 的 键 
对 象 为 参数 是 方法 的 
Meteor.methods({ < 一 名 称 
'CreateWorkout': function(data) { < 二 一 
pe 使 用 检查 以 确 
ee : 保 该 方法 中 只 
使 用 数据 

var distance = data.distance; 如 果 验 证 失败 ， 抛 出 一 个 新 

if(ldistance <= 0 || 人 > 4 和。 的 Meteor.Error。 它 像 一 个 正 
做 距离 throw new Meteor.Error('Invalid distance'); um | 常 的 JavaScript 错 误 ， 但 是 会 

验证 自动 传播 到 客户 端 
if(!'!this.userId)t 二 一 在 方法 中 通过 this 来 
throw new Meteor.Error('You have to login'); Cs Oe 
) 访问 当前 登录 用 户 的 
userld 

data.workoutAt = new Date(); 向 要 创建 的 

data.type = 'jogging'; 文档 添加 一 

data.userId = this.userId; 些 数据 

return WorkoutsCollection.insert (data); 4 你 现在 可 以 肯定 ， 添 

es 加 到 集合 的 数据 已 被 
; 保存 








如 果 看 看 这 个 方法 ， 你 会 看 到 dat a 参数 是 最 后 传递 给 Workoutscollection.insert 方 法 
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的 。 正 因为 如 此 , 确保 你 准确 地 知道 这 个 来 自 客户 端的 数据 对 象 中 包含 了 什么 是 非常 重要 的 。 如 
果 没 有 进行 任何 安全 检查 ， 用 户 可 以 在 WorkoutsCollection 和 集合 中 添加 任何 数据 。 我 们 将 再 
次 使 用 check () 函数 ， 并 更 加 详细 地 来 看 看 它 。 

使 用 audait-argument-checks 来 验证 所 有 的 用 户 输 入 

发 送 到 方法 的 每 个 参数 在 处 理 之 前 都 应 该 进行 检查 。 使 用 的 表单 域 越 多 , 就 越 难 跟踪 用 户 的 
每 个 输入 是 否 已 被 检查 过 。Meteor 中 带 有 一 个 包 auait-argument-checks， 可 用 于 检查 每 个 参 
数 确实 在 使 用 前 检查 过 。 通 过 下 面 的 命令 将 它 添加 到 你 的 项 目 中 : 


$ meteor add audit-argument-checks 


每 次 客户 端 向 服务 器 发 送 一 个 参数 进行 处 理 , audit-argument-checks 将 确保 它 首先 被 检 
查 。 你 需要 为 所 有 的 方法 添加 检查 。 如 果 没 有 检查 ,方法 仍然 会 执行 , 但 你 将 会 在 服务 器 上 看 到 
一 个 异常 ， 如 下 面 的 代码 清单 所 示 。 


代码 清单 7-13 方法 中 未 检查 的 值 将 产生 的 控制 台 消 息 

Exception while invoking method 'CreateWorkout' Error: Did not check() all arguments 
during call to 'CreateWorkout' 
at _.extend.throwUnlessAllArgumentsHaveBeenChecked (packages/check/match.js: 
) 
Object.Match._failIfArgumentsAreNotAllChecked (packages/check/match.js:108) 
maybeAuditArgumentChecks (packages/ddp/livedata_ server.js:1596) 
packages/ddp/livedata_server.js:648 
_.extend.withValue (packages/meteor/dynamics_nodejs.js:56) 
packages/ddp/livedata_ server.js:647 
_.extend.withValue (packages/meteor/dynamics_ nodejs.js:56) 
_.extend.protocol handlers.method (packages/ddp/livedata_ server.js:646) 
packages/ddp/livedata_server.js:546 


根据 期 望 的 参数 类 型 ,你 需要 使 用 不 同 的 检查 .虽然 Match .Any 可 接受 来 自 客户 端的 任何 值 ， 
但 其 他 检查 会 更 严格 。 表 7-1 列 出 了 用 于 检查 变量 内 容 的 可 用 匹配 模式 。 


表 7-1 检查 变量 内 容 的 匹配 模式 
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模 式 匹 配 

Match.Any 匹配 任何 什 

String,Number,Boolean,undefined,null 匹配 给 定 类 型 的 一 个 变量 

Match. Intger 匹配 一 个 有 符号 的 32 位 整数 。 不 匹配 无 穷 大 、 负 无 穷 大 或 NaN 

[pattern] 单元 素 的 数组 匹配 一 个 元 素数 组 ， 数 组 中 的 每 个 元 素 和 模式 匹配 。 
例如 ，[Number] 匹配 一 个 (可 能 是 空 的 ) 数字 数组 , [Match.Any] 
匹配 任何 数组 

{keyl:patternl, key2:pattern2,...} 键 的 值 与 给 定 模 式 匹配 。 如 果 有 模式 为 Match .Optional， 则 该 键 
不 需要 在 对 象 中 存在 。 值 不 能 包含 模式 中 没有 列 出 的 任何 键 。 值 必 














须 是 一 个 没有 特殊 原型 的 普通 对 象 


Match.ObjectIncluding({keyl:pattern1， 匹配 一 个 包含 给 定 键 的 对 象 ， 值 可 以 包含 其 他 的 键 及 任意 键 值 

key2:pattern2,...}) 

Object 匹配 包含 任意 键 值 的 普通 对 象 ， 等 价 于 Match.objectInclu- 
ding({}) 
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续 ) 
模 式 匹 配 

Match.Optional (pattern) 匹配 undefined 或 和 模式 匹配 的 值 。 如 果 用 在 一 个 对 象 中 , 仅仅 匹 
配 于 下 列 情况 ,如 果 该 键 未 定义 或 该 键 值 不 是 undefined 并 且 和 给 
定 的 模式 匹配 ” 

任意 构造 函数 (例如 ，Date) 匹配 给 定 类 型 的 任何 实例 

Match.Where (condition) 使 用 该 值 作 为 参数 调用 conaition 国 数 。 如 果 conaition 返 回 真 ， 
匹配 成 功 。 如 果 conaition 抛 出 一 个 Match.Error 或 返回 假 ， 则 
匹配 失败 。 如 果 condition 抛 出 任何 其 他 错误 , 则 在 调用 检查 时 抛 











出 该 错 误 
7.3 总 结 


在 本 章 中 ,你 了 解 了 以 下 内 容 。 


























口 发 布 可 以 从 数据 库 返回 数据 或 发 布 定 制 的 数据 。 




















口 订阅 可 以 是 全 局 的 或 者 只 在 单个 模板 中 使 用 。 















































口 发 布 /订阅 是 Meteor 从 服务 器 发 送 数 据 到 客户 端的 方式 。 
口 为 了 应 用 的 安全 性 ，autopublish 和 insecure 包 必须 删除 ， 发 布 和 方法 应 取代 其 位 置 。 





Qz 原文 的 表述 很 难 理解 ， 这 里 没有 按照 原文 翻译 ， 而 是 按照 我 的 理解 给 出 了 一 个 解释 





例子 ， 看 看 这 个 例子 应 该 比较 清楚 了 。 
// 在 对 象 中 


Var pattern = { name: Match.Optional (String) }; 
check({ name: "something" }，pattern) // 验证 通过 
check({}，pattern) // 验证 通过 

check({ name: undefined }，pattern) // 抛 出 异常 
check({ name: null }，pattern) // 抛 出 异常 

// 在 对 象 以 外 

check (nul1，Match.Maybe(String) ); // 验证 通过 








参考 : http://docs.meteor.com/api/check.html#matchpatterns。 


check (undefined，Match.Maybe (String)); // 验证 通过 








口 发 布 可 以 通过 文档 字段 〈 比 如 用 户 / 所 有 者 ID ) 来 安全 地 限制 所 发 布 的 数据 。 


口 通过 服务 器 端 方法 写 人 数据 库 是 安全 的 ， 比 使 用 允许 /拒绝 模式 更 灵活 。 


口 audit-argument-checks 包 有 助 于 确保 客户 端 提 供 的 所 有 数据 在 使 用 前 都 进行 了 验证 。 





。 以 下 是 官方 文档 给 出 的 一 个 
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路 由 








本 章 内 容 

口 在 Meteor 应 用 中 添加 路 由 功能 

口 创建 布局 

口 使 用 Iron .Router 改 进 代 码 结构 

口 用 控制 器 、 钧 子 和 插件 扩展 Iron .Route 
口 创建 服务 器 端 路 由 和 接口 





随 着 应 用 的 规模 和 复杂 性 不 断 增 加 ， 你 将 不 得 不 处 理 大 量 的 订阅 、 发 布 、 集 合 和 模板 。 
此 需要 一 种 方法 组 织 这 些 东 西 , 指定 要 呈现 什么 以 及 在 泻 染 的 模板 中 什么 是 可 用 的 数据 上 下 文 。 
一 个 处 理 这 种 复杂 性 的 好 方法 是 使 用 路 由 (route )。 这 意味 着 你 可 以 根据 唯一 的 URL 来 决定 
订阅 什么 、 泻 染 什 么 以 及 指定 数据 上 下 文 。 路 由 器 处 理 所 有 这 些 任务 。Meteor 中 最 常用 的 路 由 包 
































征 IYomn .Routero 























OT, Router 包 。 











Iron.Router 是 一 个 社区 包 ， 由 Chris Mather 和 Tom Coleman 维 护 。Tom 为 Meteor 开 发 了 第 一 
批 路 由 中 的 一 个 ， 称 为 meteor-router， 而 Chris 创 建 了 一 个 名 为 meteor-mini-pages 的 路 由 
项 目 。 然 而 Meteor 社 区 是 幸运 的 ， 他 们 将 各 自 的 工作 合并 ， 开 发 了 一 个 新 的 路 由 融 ， 最 终 成 为 


Meteor 开 发 小 组 曾经 在 开发 路 线 图 中 计划 自己 的 路 由 包 , 虽 然 路 由 是 每 个 Web 框 架 的 一 个 重 











要 方面 ， 但 后 来 他 们 决定 不 再 开发 了 。 因 为 由 社区 力量 构建 的 路 由 器 非常 好 ， 没 有 必要 再 开发 



































人 人 
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8.1 Web 应 用 中 的 路 由 





如 果 在 一 个 正常 的 网 站 上 单 击 一 个 链接 , 浏览 需 中 的 URL 就 会 发 生变 化 。 然 后 ,浏览 器 从 新 
URL 的 服务 器 上 请 求 资源 。Web 服 务 器 从 给 定 路 由 接收 请 求 后 所 做 的 第 一 件 事 就 是 遍历 一 个 字 
典 ， 该 字典 中 包含 服务 器 所 知道 的 所 有 路 由 。 如 果 请 求 的 路 由 与 字典 中 某 个 已 知 的 路 由 相 匹 配 ， 





则 执行 预定 义 的 动作 。 每 个 动作 结束 时 会 创建 一 个 响应 并 将 其 发 送 回 浏览 器 ， 











它 从 新 路 由 接收 到 的 HTML。 路 由 器 通常 用 于 处 至 
































E 所 有 这 些 功 能 ( 图 8-1 )。 














然后 浏览 絮 会 泻 染 


























路 由 器 发 起 党 染 过 程 并 
将 生成 的 HTML 返 回 和 在 浏览 器 中 显示 响应 
客户 端 生成 的 HTML 











图 8-1 ”服务 器 端的 路 由 器 处 理 客户 端 HTTP 请 求 并 以 HTML 格 式 进行 响应 


假定 你 在 一 个 社区 网 站 上 ， 看 到 一 个 用 户 个 人 信息 列表 。 其 中 一 个 是 Manuel。 如 果 你 单 击 
Manuel 的 链接 ,浏览 器 的 URL 将 发 生 改变 , 一 个 请 求 会 被 发 送 到 服务 器 。 服 务 器 执行 该 路 由 预定 
义 的 动作 ， 生 成 Manuel 档 案 的 HTML。 最 后 ， 响 应 被 发 送 回来 。 

使 用 Meteor 创 建 客户 端的 Web 应 用 。 这 意味 着 ， 如 果 单 击 一 个 链接 ， 将 不 会 请 求 服务 器 上 的 
另 一 个 HTML 文档 。 在 Web 应 用 中 ， 如 果 单 击 一 个 链接 ， 视 图 会 在 浏览 需 中 直接 改变 ， 不 需要 发 
送 一 个 新 的 HTTP 请 求 到 服务 器 。 这 意味 着 ， 从 技术 上 说 ， 你 不 需要 任何 路 由 ， 因 为 你 可 以 把 改 
变 DOM 的 函数 和 特定 销 元 素 单 击 事件 的 事件 处 理 程序 直接 连接 起 来 (图 8-2 )。 

当 用 户 个 人 信息 的 链接 列 在 网 站 上 时 ， 其 处 理 过 程 和 静态 网 站 是 完全 不 同 的 。 如 果 你 单 击 
Manuel 的 个 人 信息 链接 ，UREL 不 会 改变 ， 一 个 JavaScript 事 件 处 理 函 数 会 在 浏览 器 中 直接 处 理 单 
击 。DOM 在 单 击 时 可 以 直接 改变 并 显示 一 个 加 载 指示 器 ， 比 如 一 个 简单 的 字符 串 oadqing. ..。 
同时 ， 应 用 会 从 服务 器 提取 需要 的 数据 ， 用 以 显示 个 人 信息 。 在 Meteor 中 ， 可 通过 更 新 或 创建 
一 个 新 的 订阅 来 做 到 这 一 点 。 如 果 新 的 数据 在 客户 端 可 用 ，DOM 会 进行 更 新 ， 新 的 个 人 信息 会 
被 显示 。 

如 果 像 这 样 基于 单 击 事件 修改 当前 的 HTML 而 不 改变 浏览 器 的 URL， 它 会 影响 应 用 的 可 维 
护 性 。 如 果 要 快速 找到 去 哪里 看 你 的 代码 ， 让 URL 结 合 一 个 应 用 能 够 理解 的 路 由 字典 将 是 一 个 
很 好 的 起 点 。 假 设 你 要 加 入 一 个 项 目 ， 该 项 目 中 创建 了 一 个 复杂 的 应 用 ， 而 且 它 对 你 来 说 是 全 
新 的 。 如 果 你 单 击 社区 网 站 的 一 个 个 人 信息 链接 ，URL 变 为 profiles/manuel， 你 可 以 从 所 定义 的 
路 由 开始 ， 查 看 它 执 行 了 什么 动作 。 可 以 使 用 这 个 URL 作 为 第 一 提示 来 寻找 相关 的 代码 ， 这 是 
非常 重要 的 。 
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事件 处 理 程序 监听 单 击 
事件 并 直接 改变 DOM 





















































通过 发 布 和 订阅 同步 
图 8-2 ”客户 端的 Web 应 用 可 以 在 事件 处 理 程序 中 处 理 DOM 操 作 









































为 什么 即使 在 客户 端 应 用 中 也 应 该 总 是 使 用 URL? 其 主要 原因 在 于 Web 本 身 的 体系 结构 。 
URL 定 义 了 可 以 在 Web 上 获取 的 每 个 资源 。 它 使 你 能 够 与 朋友 分 享 内 容 。 如 果 你 的 社区 应 用 只 包 
括 一 个 URL, 你 将 不 能 与 任何 人 分 享 一 个 有 趣 的 个 人 信息 。 如 果 要 执行 某 些 操作 ， 如 对 表 进 行 过 
滤 或 排序 , 将 这 些 操 作 反 映 在 URL 上 是 很 好 的 。 考 虑 一 个 你 需要 经 常 访问 的 大 数据 集 , 该 数据 访 
问 需 要 特殊 但 非常 重要 的 过 滤 和 排序 组 合 。 如 果 能 通过 一 个 URL 来 访问 这 个 精确 的 数据 集 , 你 就 
很 容易 把 它 添加 到 书签 ， 和 你 每 次 需要 访问 时 都 进行 配置 比 起 来 ， 这 要 快 得 多 。 

URL 不 仅 对 人 类 浏览 网 页 很 重要 ， 对 应 用 本 身 也 很 重要 。 搜 索引 擎 抓 取 网 站 时 ， 它 总 是 试图 
理解 关联 到 某 个 特定 URL 的 文档 内 容 。 如 果 用 户 在 搜索 栏 输入 要 搜索 的 短语 , 搜索 引擎 将 尝试 给 
出 最 佳 匹 配 的 URL 作 为 响应 。 如 果 你 的 应 用 包含 的 所 有 内 容 只 有 一 个 URL, 搜索 引擎 就 不 能 正确 
地 将 访问 者 重 定向 到 与 用 户 搜索 的 短语 相关 的 确切 视图 。 

为 路 由 对 Meteor 应 用 是 如 此 重要 , 所 以 Iron .Router 实 现 了 一 个 路 由 器 。 该 路 由 器 在 客户 
端 和 服务 器 端 都 可 用 。 在 客户 端 ， 路 由 器 可 以 基于 给 定 的 URL 帮 助 你 建立 新 的 订阅 , 结束 旧 的 订 
阅 , 此 外 , 它 基 于 当前 的 URL 演 染指 定 的 模板 ( 图 8-3 ), 正 如 你 在 这 一 章 中 会 看 到 的 ,Iron.Router 
还 有 更 多 的 功能 。 






































Iron.Router 对 URL 的 更 
改作 出 响应 ， 并 执行 指 
定 的 操作 
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处 理 新 的 订 
阅 和 渲染 








改变 URL 








通过 发 布 和 订阅 同步 
图 8-3 ”Iron.Router 监 听 URL 的 更 改 并 执行 路 由 定义 的 操作 


你 也 可 以 将 Iron.Router 作 为 一 个 正常 的 服务 器 端 路 由 使 用 。 这 意味 着 你 可 以 创建 一 个 
Meteor 应 用 的 REST 接 口 。Iron .Router 的 主要 用 例 是 客户 端 路 由 ， 这 是 本 章 的 重点 。 但 在 本 章 
结束 时 ， 我 们 也 会 看 看 服务 器 端的 路 由 。 


8.2 客户 端 路 由 


在 这 一 节 中 ， 我 们 将 向 你 展示 如 何 使 用 Iron .Router 实 现 客户 端 路 由 。 路 由 器 组 件 将 只 运 
行 在 客户 端 上 ， 让 你 可 在 无 需 与 服务 器 联系 的 情况 下 进行 导航 。 

你 将 创建 一 个 社区 应 用 , 在 其 中 你 可 以 看 到 用 户 的 个 人 信息 和 该 页 面 上 的 评论 。 这 样 一 个 应 
用 (几乎 任何 Web 应 用 ) 的 一 个 重要 方面 是 URL 分 享 。 想 想 你 在 我 们 新 社区 网 站 上 的 个 人 信息 页 
面 。 如 果 该 页 面 没 有 独特 的 URL， 你 将 不 能 与 任何 人 分 享 它 ， 甚 至 连 你 自己 也 无 法 访问 它 。 

在 本 章 的 最 后 ， 你 将 建立 一 个 应 用 ， 它 可 以 包含 无 限 数量 的 个 人 信息 页 面 ， 每 个 页 面 都 
有 唯一 的 、 可 共享 的 URL。 每 个 个 人 信息 页 面 都 将 有 一 个 专用 的 URL 来 显示 其 内 容 ， 如 图 8-4 
所 示 。 我 们 的 应 用 将 含有 多 个 路 由 ， 不 仅 用 于 静态 页 面 ， 也 用 于 那些 需要 数据 来 演 染 模板 的 
动态 页 面 。 
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€ 3 CC D localhost:3000/profiles/manuel 3 





My Little Community About 


Manuel Schoebel 


llike to eat good food and also cooking it myseif! 














图 8-4 单 页 面 社区 应 用 的 一 个 简单 的 个 人 信息 页 面 





8.2.1 添加 Iron.Router 


Meteor 的 核心 不 带 有 路 由 器 , 但 如 前 所 述 ，Iron .Routezr 是 一 个 高 质量 的 包 ,， 由 Meteor 社 区 
开发 并 且 维 护 得 很 好 。 对 你 的 Meteor 项 目 而 言 ， 必 须 首 先 添 加 Iron .Router 包 : 


$ meteor add iron:router 


一 旦 添加 了 Iron.Router， 你 就 可 以 在 应 用 的 客户 端 和 服务 器 环境 中 访问 Router 对 象 。 
此 ， 你 也 可 以 使 用 它 来 执行 服务 器 端 路 由 。 我 们 稍 后 会 回 到 服务 器 上 使 用 Router。 

在 应 用 文件 夹 的 根 目录 下 创建 一 个 路 由 器 (router ) 文件 来。 这 个 文件 夹 里 面 ， 将 存放 所 有 
路 由 相关 的 文件 ， 让 我 们 从 routesjs 文 件 开始 ， 它 包含 所 有 的 路 由 定义 (图 8-5 )。 

















| » Ml client 

> A public 

| v 转 router 
0 routes.js 

| > | server 











图 8-5 ”Iron.Router 在 客户 端 和 服务 右上 都 能 工作 ， 所 以 要 把 routes.js 文 件 放 在 客户 
端 或 服务 器 以 外 的 文件 夹 ， 使 它 在 各 种 环境 下 都 可 访问 


routes.js 文 件 将 定义 应 用 应 该 包含 的 所 有 路 由 。 把 应 用 的 所 有 路 由 都 放 在 一 个 文件 中 是 个 很 
好 的 做 法 ， 这 让 你 可 以 快速 地 浏览 路 由 。 
8.2.2 创建 第 一 个 路 由 


下 一 个 目标 是 建立 两 个 基本 路 由 。 一 个 是 标准 的 主页 (home ) 路 由 ， 它 应 该 在 应 用 的 根 进 
行 泻 染 。 此 路 由 与 路 径 / 有 关 。 第 二 个 路 由 是 简单 的 关于 (about ) 页 面 ， 这 是 当 用 户 访问 /abonut 
URL 时 应 该 呈现 的 页 面 (参见 图 8-6 )。 
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四 四 四 /EIMyutecommunity x VE ®@®@ /EM utecCommunity xD 

















€ 3 CC |D localhost:3000 € SQ OD localhost:3000/about 
My Little Community (Capou ) My Little Community About 
Home About 


图 8-6“ 单 击 顶部 导航 中 的 About 链 接 将 把 URL 改 为 /about 





说 明 为 了 减少 代码 的 复杂 性 , 我 们 不 会 显示 任何 bootstrap 标 记 。 本 章 可 供 下 载 的 代码 中 包含 所 
有 相关 的 bootstrap 代 码 ， 以 实现 更 漂亮 的 外 观 。 要 添加 Bootstrap CSS 框 架 ， 你 必须 添加 
twbs:bootstrap 包 。 


第 一 步 中 将 要 使 用 的 文件 结构 如 图 8-7 所 示 。 


v Ml client 
v MM views 
v home 
g@ home.html 
gj index.html 
v Ml staticPages 
®) about.html 





v 天 router 
霹 ] routes.js 


图 8-7 要 创建 两 个 简单 的 路 由 ， 你 必须 定义 每 个 路 由 以 及 每 个 路 由 应 该 泻 染 的 模板 




















当 用 户 在 根 路 径 / 上 时 ，home.html 文 件 ( 见 代 码 清单 8-1 ) 中 包含 了 应 该 泻 染 的 模板 。 从 /. 
导航 到 /about 页 面 将 进入 一 个 静态 页 面 ， 其 中 显示 了 该 应 用 进一步 的 信息 。 为 实现 这 个 ， 你 将 
使 用 一 个 存储 在 静态 文件 夹 中 的 about 模 板 。index.html 文 件 包 含 一 些 通用 的 模板 以 及 应 用 的 
<head> 元 素 。 


代码 清单 8-1 社区 应 用 的 初始 模板 
// index.html 


<head> 
<title>My Little Community</title> Re a 
头 模板 包含 导航 ， 这 


</head> 样 它 可 以 包含 在 其 他 
< | 模板 中 


<template name="header"> 
<nav> 

<ul> 
<li><a href="/">My Little Community</a> 
</1i> 
<li><a href="/about">About</a> 
</1i> 

</ul> 
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</nav> 
</template> 


// home.html 
<template name="home"> 
{{> header}} 


<h1l>Home</hi1> 
</template> 


// about.html 
<template name="about"> 
{{> header}} 


<h1l>About</hi> 
</template> 


没有 什么 太 花 哨 的 模板 。 


模板 包括 头 模板 ， 
这 样 导航 将 在 每 
一 个 视图 的 项 部 


< 一 


headezr 模 板 内 部 的 导航 包含 两 个 锚 元 素 。 一 个 链接 到 根 路 径 <a 


href="/">My Little Community</a>， 男 一 个 链接 到 关于 页 面 <za href="/about">About 


</a>。 下 一 步 ， 你 要 将 这 些 路 由 添加 到 Iron .Router， 并 使 用 下 面 代 码 清单 中 的 代码 显示 适当 


的 模板 。 





代码 清单 8-2 ”设置 不 同 的 路 由 


// routes.js 


Router.route('/', 





> this.render(' 
泻 染 指定 | 。 )) 
的 模板 
Router.route('/a 
[> 











this.render('a 


二 


Router 对 象 有 一 个 route 


路 径 和 指定 的 路 径 匹 配 ， 相 关 


function(){ > 

home ' ) ; 定义 一 个 路 径 , URL 匹 配 
这 个 路 径 时 , 将 它 与 一 个 
函数 调用 联系 起 来 





Dout ss unetrom(y)t 


bout '); 





困 数 , 它 需要 两 个 参数 : 路 径 和 相关 的 函数 。 如果 URL 改 变 并 且 其 
函数 将 被 调用 。 在 调用 函数 的 范围 内 ， 你 可 以 通过 this 访 问 所 谓 





的 RouteController 对 象 的 当前 实例 ,在 Routecontroller 的 帮助 下 ,你 可 以 泻 染 模板 到 DOM 


中 的 指定 位 置 。 在 这 种 情况 下 
函数 的 


> Ah dD 


字符 中 





， 因 为 没有 其 他 的 定义 ， 所 以 this.render('templateName') 





参数 所 指定 的 模板 将 被 泻 染 在 <body> 元 素 内 。 


8.2.3 ”基于 路 由 定义 布局 
对 于 整个 应 用 ， 你 要 保持 一 致 的 布局 ， 例 如 ， 保 持 主 导航 菜单 在 项 部。 因此 ， 可 以 为 所 有 路 


由 设置 默认 布局 。 另 外, 一些 路 由 可 


页 使 用 更 大 的 单个 图 像 文件 。 
1. 单一 的 布局 





全 bE 
EFT 


要 不 同 的 布局 。 首 页 将 并 排 显示 多 个 图 像 ， 而 个 人 信息 








在 前 面 的 示例 中 ,我 们 应 用 中 演 染 的 每 个 模板 都 包含 了 顶部 的 导航 ( 参见 图 8-8 )。 
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©@O@ /Ewutecomnmny xi 


€ 3 CC | localhost:3000 











<template name="home"> 
{{> header}} 


My Little Community About 


</template> 





Home 








©@ 上 /EM utecCommunity x (ER 
€ SC 0 localhost:3000/about 


My Little Community About 








<template name="about "> 
{{> header}} 


</template> 





About 
图 8-8 在 每 个 路 由 中 重用 模板 而 不 使 用 布局 


一 个 更 有 效 重用 头 模板 的 方法 是 对 每 个 路 由 使 用 布局 模板 , 然后 只 基于 当前 路 由 来 改变 布局 
的 一 部 分 。 如 果 布 局 变 得 更 加 复杂 , 或 者 在 单个 应 用 中 必需 使 用 多 个 布局 时 , 这 个 方法 特别 有 用 。 
正如 你 在 图 8-9 中 看 到 的 , 对 于 这 两 个 路 由 , masterLayout 模 板 都 应 该 被 泻 染 , 所 以 header 
模板 总 是 在 顶部 。 动 态 部 分 根据 当前 路 由 更 改 。 如 果 当 前 路 径 是 /, 则 布局 的 动态 部 分 应 该 用 home 
模板 来 替换 ;如 果 路 径 更 改 为 /about ， 则 布局 的 动态 部 分 必须 由 about 模 板 进行 蔡 换 。 
































































































<template name="masterLayout"> 
{{> header}} 


<div class="container'"> 
{{> yield}} 





</div> 
</template> 








重用 masterLayout 
和 header 模 板 





O00 /Ewuwecormny x (i 


| {{> header}} 
















<div class="container"> 
{{> yield}} 

</div> 

</template> 











图 8-9 ”{{ > yeild}} 是 一 个 动态 区 域 ， 应 该 由 当前 路 径 需要 泻 染 的 模板 来 替换 
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在 布局 模板 中 , 你 使 用 了 {{> yielda} } 模 板 辅助 函数 ,， 它 由 Iron .Routetr 包 和 定义。 使 用 {{> 
yield}}, 你 可 以 确切 地 指定 需要 演 染 路 由 模板 的 地 方 , 它 是 一 个 内 容 的 占 位 符 。 这 就 是 所 谓 的 
区 域 (region )。 

记 住 ， 把 你 视图 模板 中 的 代码 合并 到 masterLayout 模 板 ， 如 下 面 的 代码 清单 所 示 。 


代码 清单 8-3 ”将 布局 相关 的 标记 移动 到 公共 的 布局 模板 
// masterLayout.html 
<template name="masterLayout"> 
{{> header}} 








<div class="container"> 
{{> yield}} 
</div> 
</template> 


// home.html 

<template name="home"> 
<h1l>Home</hi1> 

</template> 


要 指定 每 个 路 由 的 布局 ， 必 须 在 Router 对 象 内 通过 configure () 函数 来 设置 。 为 了 把 这 个 
配置 和 路 由 定义 分 开 ， 把 下 面 的 内 容 放 在 一 个 新 的 文件 router/config.js 中 : 
Router.configurel({ 


layoutTemplate: 'masterLayout' 
县 


2. 使 用 多 个 布局 

你 需要 两 个 布局 来 区 分 个 人 信息 页 面 和 首页 , 而 不 是 对 所 有 的 路 由 使 用 单个 布局 模板 。 首 先 ， 
让 我 们 看 看 老 的 masterLayout 模 板 和 新 的 profileLayout 模 板 (网 8-10 )。 

正如 所 见 , 个 人 信息 布局 有 两 列 。 左 列 显示 图 片 ， 右 列 为 个 人 信息 。 还 有 一 个 主要 的 内 容 区 
域 由 { {> yield}} 模 板 辅助 函数 指定 。 左 边 的 第 二 个 区 域 需要 一 个 名 称 ， 这 样 它 就 可 以 在 后 面 
的 route 函 数 中 引用 。 为 此 ， 你 可 以 使 用 一 个 命名 的 区 域 ， 就 像 这 样 : {{> yielgd "name"}}。 

在 route 函 数 中 可 以 指定 要 使 用 的 布局 ， 如 果 不 指定 ， 将 使 用 configure 函 数 设置 的 布局 。 
如 果 configure 限 数 中 也 没有 指定 布局 ,那么 该 模板 将 直接 泻 染 到 <body>( 见 下 面 的 代码 清单 )。 


代码 清单 8-4 ”在 route 函 数 中 设置 布局 






















































































Router.route('/profiles/manuel', function () { 设置 布局 
this.layout ('profileLayout'); < 一 
this.render('profileDetail'); 布局 模板 用 于 泻 染指 定 


有 的 profileDetail 模 板 











朵 | 3 <template name="masterLayout"> 
| My Little Community About - {{> heagder}} 





<div> 
{{> yield}} 








</div> 
| Home ! </template> 








materLayout 模 板 


profileLayout 模 板 


<template name="profileLayout"> 
{{> header}} 














oOe@e 癌 wy Lttle Community x NE 








€ DS CC | localhost:3000/profiles/manue 





| | My Little Community About 





<div class="left"> 
{{> yield "left"}} 
</div> 

<div class="right"> 
{{> yield}} 

</div> 
</template> 











Manuel Schoebel 


1 like to eat good food and also cooking it myseif! 























图 8-10 个 人 信息 页 的 第 二 个 布局 ， 它 应 该 用 于 个 人 信息 页 面 的 路 1 


3. 为 命名 区 域 定义 内 容 模 板 

如 果 你 如 前 面 的 {{> yiela "left"}} 那 样 , 命名 了 几 个 区 域 ,你 需要 指定 在 那里 演 染 什 
么 模板 。 可 以 在 以 下 的 几 种 方式 种 选择 一 个 来 做 这 件 事 。 

最 简单 的 方法 是 在 模板 内 部 。 EON Router 使 用 名 为 contentFor 的 模板 辅助 函数 ,让 你 定 
义 特 定 区 域 的 内 容 〈 见 代码 清单 8-5 )。 这 块 区 域 以 外 的 任何 东西 都 被 演 染 到 主 区 域 。 


代码 清单 8-5 ”使 用 模板 辅助 函数 在 一 个 命名 区 域内 演 染 模板 


// profileDetail.html 
























































De 一 

<template name="profileDetail"> 块 的 四 容 将 起 

{{#contentFor 'left'}} 了 染 在 命名 区 域 
<img src="..."> left 中 


{{/contentFor}} 





<h1>Manuel Schoebel</h1> 这 些 将 泻 染 
<p>I like to eat good food angd also cooking it myself!</p> 到 主 区 域 


</template> 
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你 也 可 以 使 用 contentFor 直 接 指 定 要 尝 染 的 模板 : 
{{> contentFor region='left' template="profileImage"}} 


定义 区 域内 容 最 灵活 的 方法 是 在 路 由 定义 中 。render () 函数 有 个 to 选项 ， 可 以 指定 要 演 染 
模板 和 数据 的 区 域 ( 见 下 面 的 代码 清单 )。 


代码 清单 8-6 ”使 用 JavaScript 在 一 个 命名 区 域 中 演 染 一 个 模板 














// profileDetail.html 使 用 模板 辅 
<template name="profileDetail"> 助 函 数 设置 
{{> contentFor region='left' template="profileImage"}} < 一 模板 和 区 域 
<hi>Manuel Schoebel</h1> 这 将 泻 染 
<p>I like to eat good food angd also cooking it myself!</p> 到 主 区 域 
</template> 


<template name="profileImage"> 

<TNo Tare 
</template> 选项 “to” 指定 
在 哪里 泻 染 给 定 
的 模板 


// routes.js 

Router.route('/profiles/manuel', function () { 
this.layout ('profileLayout'); 
this.render('profileImage', {to: 'left'}); 
this.render('profileDetail'); 

}); 

你 以 静态 方式 定义 了 一 个 特定 个 人 信息 的 路 由 , 原因 是 使 用 了 路 由 /profiles/manuel。 当 


然 ， 你 希望 定义 一 个 通用 的 详细 个 人 信息 页 面 的 路 由 ， 接 下 来 你 将 会 看 到 。 
8.2.4 根据 路 由 设置 数据 上 下 文 


在 我 们 应 用 的 主页 路 由 上 , 你 希望 有 多 个 个 人 信息 的 链接 指向 他 们 的 详细 信息 页 面 。 个 人 详 
细 信 息 页 面 应 该 有 一 个 模板 ， 该 模板 泻 染 通过 该 URL 指 定 的 单个 个 人 信息 。 这 意味 着 路 由 
/ptofiles/stephan 应 该 使 用 Stephan 的 数据 来 泻 当 个 人 详细 信息 模板 。 路 由 /profiles/ 
manuel 也 应 该 泻 染 个 人 详细 信息 的 模板 ,但 使 用 的 是 Manuel 的 个 人 信息 数据 (图 8-11 )。 

图 8-11 显 示 了 本 章 中 将 实现 的 核心 功能 。 它 需要 在 主页 路 由 上 显示 的 个 人 信息 列表 ， 一 个 将 
重 定向 到 个 人 信息 URL 的 more... 链 接 ， 以 及 一 个 显示 详细 个 人 信息 的 动态 路 由 。 

主页 路 由 的 数据 上 下 文 必须 是 一 组 应 演 染 的 个 人 信息 。 在 个 人 信息 的 详细 页 面 上 , 你 只 需要 
一 个 用 户 的 数据 作为 profileDetail 模 板 的 上 下 文 。 因 为 该 URL 已 经 定义 了 数据 上 下 文 ， 所 以 
需要 使 用 Iron .Routezr 来 设置 它 。 
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®@o@ /EMuUtecommunity -x CO 
€ FC 口 ocalhost3000 





Layout 








My Little Community About 





单 击 more... 链 接 


























_id: 'Stephan', 
了 


name: 'Manuel', 



























































将 泻 染 个 人 信 Stephan Manuel Img DEB wt 
自 Into Yoga, heaith food, Iong walks on I like to eat good food and also cooking a 
息 详 细 页 面 the beach, and being In the dunes on tt myself! } 
和 Co ) 
Layout 
Cy ee om @ 9 ® /wu crm 和 7 0 
€ $ GD ocanoet3000/brofios WaY DgK37eSNmSPgs 了 CD ocanost3000 /Prof APTePSonF2roMeZNO 1 1! 出 
My Little Community 。 About My Little Community About ! 人 ----------------------------: ! 
! | profile profile |! 
| Img . Detail. | ! 
Sat Manuel | wn | Lr | 
eh ec on cate maa ep | 
和 
上 
Path: /profiles/6RwqQML6ivpf5cj93 Path: /profiles/iMBBTWJWXefNQ6FeP 
Data Data 
{ { 
name: 'Stephan', name: 'Manuel:, 
Te 汪 届 下 本 过 证 2 et Ty 
_id: ‘6RwqQML6ivpf5cj93', _id: ‘iMBBTWJWXefNQéFeP' ， 
.| } 
图 8-11 使 用 Iron.Router， 你 可 以 定义 模板 、 布 局 和 数据 上 下 文 





为 了 让 事情 更 简单 ， 








让 我 们 假设 autopublish 包 仍然 有 效 ， 


以 便 在 客户 端 上 访问 所 有 的 个 





人 信息 数据 。 你 还 需要 所 有 的 个 人 信息 数据 在 Profilescollection 中 可 用 。 可 回 到 第 7 章 学 习 
如 何 设 置 数 据 的 发 布 和 订阅 以 限制 客户 端 上 的 数据 访问 。 
相关 的 逻辑 位 于 routes,js 文 件 ( 见 代 码 清单 8-7 )。 你 现在 有 三 个 路 由 : home 或 /、/about 和 
个 动态 的 /profiles 路 由 ， 它 接收 一 个 用 户 ID 作为 URL 参 数 ， 用 户 ID 用 于 确定 哪个 个 人 信息 
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需要 显示 。/about 路 由 保持 不 变 ， 但 其 他 两 个 需要 更 新 。 

现在 ，home 路 由 设置 home 模 板 的 数据 上 下 文 。 它 返回 一 个 对 象 ， 对 象 中 包含 在 客户 端 上 可 
访问 的 所 有 个 人 信息 ， 并 使 它们 可 以 通过 profiles 访 问 。 这 使 得 在 home 模 板 中 的 {{#each 
profiles})...{{/each} ) 结 构 中 可 以 访问 所 有 的 个 人 信息 。 没有 必要 定义 返回 数据 的 模板 辅助 
函数 ; Iron .Router 可 以 处 理 这 件 事 情 。 


代码 清单 8-7 使 用 Iron.Router 设 置 数据 上 下 文 


// routes.js 
















































































个 人 信息 
Router.route('/', function(){ 个 人 信息 可 在 主页 
this.render('home', { 模板 中 通过 、 
data: function(){ < 一 {tprofiles}} 访 问 
return {profiles: ProfilesCollection.find()}; < 一 
} 
有 
py) 
Router.route('/about', function(){ 设置 泻 染 
冒号 this.render('about'); i 
S| ed 模板 的 数 
器 会 据 上 下 文 
es 
变量 
Router.route('/profiles/:_id', function()t{ 
pe profile = ProfilesCollection.findOone({_id: this.params._id}); 
通过 this.layout('profileLayout'); 
this.params.key this.render('profileDetailLeft', { 
访问 路 径 变 量 BO te 
, 
data: function(){ 
return profile; 
ee 数据 可 直接 访问 , 例如 ， 
’ 通过 个 人 信息 模 A 
this.render('profileDetail', { 通过 个 人 信息 模板 中 的 
{{name)}} 
Ca data: function(){ 
设置 泻 染 return profile; 
模板 的 数 } 
据 上 下 文 }); 


}); 

对 于 个 人 信息 的 详细 页 面 ， 你 期 望 的 路 径 是 /profiles/:_id。 前 面 的 : (冒号 ) 表示 _ia 
是 一 个 变量 , 它 是 从 URL 读 取 的 。 它 的 内 容 可 以 通过 当前 路 由 控制 器 实例 的 params 属 性 来 访问 。 
使 用 this .params ._id 来 访问 该 URL 的 当前 值 。 这 样 就 可 以 确定 需要 从 数据 库 中 提取 哪个 文档 。 
让 我 们 仔细 看 看 aata 选 项 。 
































8.2.5 使 用 Iron.Router 订阅 数据 


你 已 经 看 到 依赖 于 当前 路 由 的 几 个 方面 : 应 该 使 用 的 布局 、 需 要 进行 演 染 的 模板 以 及 要 查看 
的 数据 。 通 常 ，autopuplish 包 无 法 在 一 个 包 内 使 用 ， 所 以 必须 根据 当前 路 由 动态 订阅 数据 。 
在 社交 社区 的 主页 上 , 假设 你 想 展示 一 些 随机 的 个 人 信息 , 但 最 多 10 条 。 这 就 涉及 数据 订阅 。 
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导航 到 一 个 个 人 信息 的 








但 你 只 想 在 主页 路 由 上 订阅 它 , 而 不 是 在 所 有 时 间 都 订阅 这 个 数据 。 如 引 


详细 页 面 ， 就 不 需要 这 10 个 个 人 信息 了 。 
首先 ， 你 会 从 应 用 中 删除 autopublish 包 。 在 服务 嚣 上， 为 了 模拟 网 络 延迟 ， 你 将 创建 一 


个 包含 轻微 延迟 的 发 布 。 下 面 的 代码 清单 显示 了 服务 器 上 的 发 布 代码 。 





代码 清单 8-8 ”使 用 一 秒 延 迟 发 布 个 人 信息 集合 


// publications.js 
Meteor.publish('profiles', 
profiles = Meteor.wrapAsync (functi 


Meteor.setTimeout (function () { 
ProfilesCollection.find({}, 


此 代码 模拟 
4 等 待 时 间 


function () { 
an (eB) 并 


{ <] 到 MongoDB 的 实际 查询 在 这 


cb (nul1l， 
人 里 发 生 ， 结 果 存 储 在 个 人 信息 
限制 发 布 为 10 变量 中 
A 个 个 人 信息 
(3 
return profiles; < 
) ) ; 从 发 布 中 返回 
MongoDB 查 询 的 
集合 游标 


下 一 步 ， 你 需要 从 客户 端 订 阅 该 发 布 。 让 我 们 从 home 路 由 开始 。 你 将 传递 一 个 对 象 作为 第 
二 个 路 由 参数 ， 而 不 是 使 用 简单 的 this .render () 调用。 其 结果 是 相同 的 ,但 语法 不 同 ( 见 下 






































面 的 代码 清单 )。 
代码 清单 8-9 ” 仅 通 过 选项 定义 路 由 的 行 > 
模板 选项 指定 要 泻 
Router.route('/', { 8 a 
template: 'home', 染 的 模板 使 用 data 选 项 设置 数 
data: function() { < 二 一 据 上 下 文 
return { 
profiles: ProfilesCollection.find({}, {limit: 10}); < 
从 ProfileCollection 


} 
: 返回 10 个 个 人 信息 
正如 你 看 到 的 , 通过 使 用 选项 而 不 是 route 函 数 ， 你 节省 了 一 些 代 码 ， 对 于 这 种 简单 的 用 例 


它 可 以 完美 地 工作 。 
在 等 竺 数据 时 ， 你 希望 应 用 泻 染 一 个 加 载 指示 器 。Iron .Router 带 有 一 个 waiton 选 项 ， 它 
PR 


等 
可 以 用 来 定义 所 有 需要 的 订阅 (代码 清单 8-10 )。 使 用 waiton 选 项 的 时 候 ， 一 个 加 载 模板 会 自动 
尔 可 以 在 路 由 选项 中 做 这 件 事 ， 


显示 。 可 以 通过 loadqingTemplate 选 项 来 修改 默认 的 加 载 模板 。4 
也 可 以 在 全 局 的 路 由 配置 中 为 整个 应 用 配置 加 载 模板 。 
































代码 清单 8-10 ”基于 路 由 的 订阅 


Router.route('/', { 
waiton: function () { 
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Re Meteor.subscribe('profiles'); < 一 如 果 等 待 多 个 订阅 ， 
template: 'home', 你 也 可 以 使 用 一 
data: function () { 数组 
return { 
profiles: ProfilesCollection.find({}, { 
limit: -10 


当 home 路 由 被 请 求 时 ， 你 会 看 到 一 个 加 载 指示 器 ， 如 图 8-12 所 示 。 一 旦 订阅 准备 好 ，home 
模板 将 以 正确 的 数据 进行 泻 染 





| DD localhost:3000 


My Little Community About 


Loading... 














图 8-12 ”使 用 waiton 时 ，Iron.Router 将 自动 泻 染 加 载 指示 器 














同样 的 技术 可 用 于 显示 单个 个 人 信息 。 要 告诉 应 用 需要 显示 的 个 人 信息 , 你 还 必须 包括 所 请 
求 的 个 人 信息 也。 如 前 所 述 ,你 可 以 使 用 this .params ._iq 将 其 传递 给 订阅 。 在 不 使 用 renqaer () 
函数 时 ， 路 由 看 起 来 如 下 面 的 代码 清单 所 示 。 


代码 清单 8-11 等 竺 单个 个 人 信息 的 订阅 和 


Router.route('/profiles/:_id', { 
layoutTemplate: 'profileLayout', 
waiton: function() { 
return Meteor.subscribe('profile', this.params._id); 





} 
template: 'profileDetail', 
yieldTemplates: { 
'profileDetailLeft': { 
QO Gt 
lj 
} 
data: function() { 
return ProfilesCollection.findOonel({ 
_id: this.params._id 
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这 些 都 是 创建 单 页 应 用 所 需 的 基本 构建 组 件 。Iron .Routez 不 仅 可 以 帮助 你 组 织 代 码 ， 而 
且 还 可 以 让 你 准确 地 定义 需要 演 染 哪些 模板 、 哪 些 订 阅 是 必需 的 、 哪 些 数据 应 该 在 模板 的 数据 上 








下 文中 可 用 。 
准备 好 更 进一步 了 吗 ? 让 我 们 来 看 一 些 更 高 级 的 用 例 。 


8.3 ”高 级 的 路 由 方法 








在 本 章 的 其 余部 分 ， 我 们 将 看 看 应 用 中 常用 的 高 级 技术 。 它 们 和 下 面 的 这 些 内 容 相关 。 
使 用 命名 的 路 由 ， 以 便于 在 控制 顺和 搬 件 中 方便 地 引用 和 组 织 代码 














口 可 维护 性 
口 外 观 一 一 以 不 同 的 类 "突出 显示 活动 的 链接 














口 性 能 一 一 仅 为 特定 路 由 加 载 外 部 库 
口 功能 一 一 使 用 钩子 添加 视图 计数 带 ， 防 止 匿名 用 户 访问 路 由 





8.3.1 使 用 命名 路 由 和 链接 辅助 函数 














不 要 在 应 用 中 硬 编 码 任何 链接 ， 如 锚 元 素 的 href 属性 。 因 为 如 果 路 由 更 改 ， 你 必须 手动 纺 


























辑 所 有 人 硬 编码 链接 ， 所 以 链接 路 径 最 好 依赖 于 路 由 名 称 并 使 用 辅助 函数 来 生成 。 与 模板 一 样 ， 你 
可 以 给 路 由 一 个 名 称 , 并 使 用 它 来 引用 路 由 。 路 由 的 名 称 是 路 由 定义 中 的 一 个 选项 。 要 链接 到 一 















































个 命名 的 路 由 ， 可 使 用 pathFor 模 板 辅 助 函 数 。 


代码 清单 8-12 显 示 了 如 何 链接 到 命名 的 路 由 。 一 个 个 人 信息 页 需要 一 个 个 人 信息 ID 来 正确 地 


显示 它 的 内 容 。 在 这 种 情况 下 ， 路 由 名 profile 必 须 填充 一 个 _iq 变 量 ，{ {pathFor}} 模 板 辑 











上 助 


函数 必须 可 以 访问 它 。 通 过 Iron .Router 来 设置 数据 上 下 文 ， 或 使 用 {{#witn}} 块 辅助 函数 来 





传递 _ia 值 是 可 能 的 。 代 码 清单 8-12 使 用 Iron .Router 来 设置 上 下 文 。 
代码 清单 8-12 ”使 用 命名 的 路 由 


// routes.js 

Router.route('/', { name: 'home' }); 

Router.route('/about', 'about', { name: 'about' }); 
Router.route('/profiles/:_id', { name: 'profile.details' }); 





// index.html 
<template name="header"> 
<nav> 


<ul> 
<li><a href="{{pathFor 'home'}}">My Little Community</a></1i> 
<li><a href="{{pathFor 'about'}}">About</a></1i> < 一 


< HL 链接 到 /about 


</nav> 
</template> 





Q 此 处 的 类 指 CSS 中 的 class。 一 一 译 者 注 
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// profilePreview.html 


<template name="profilepreview"> 个 人 信息 路 由 需 
<img src="{{profileImg}}"> 要 : _id， 它 继承 了 
<div> profilePreview 模 板 

<h3>{{name}}</h3> 的 数据 上 下 文 


<p>{{profileText}}</p> 
<a href="{{pathFor 'profile.details'}}">more...</a> 
</div> 
</template> 


使 用 { {pathFor}} 时 ， 它 返回 一 个 相对 URL， 使 其 在 不 同 的 部 署 环境 中 都 能 工作 得 很 好 。 
如 果 需 要 一 个 绝对 的 URL， 你 应 该 使 用 { {urlFor}}。 第 三 个 选择 是 { {#1inkTo}}, 它 在 这 一 章 
前 面 也 使 用 过 。 它 泻 染 锚 元 素 ， 并 允许 在 它 的 标签 之 间 包 含 内 容 ， 比 如 提供 一 个 链接 文本 时 ( 见 
下 面 的 代码 清单 )。 


代码 清单 8-13 ”使 用 1inkTo 块 辅助 函数 来 演 染 销 元 素 


{{#1inkTo route='about'}}About{{/linkTo}} 








// 洽 梁 型 
<a href=""/about">About</a> 


{{#1inkTo route='home' class='navbar-brand'}} 
My Little Community 
{{/linkTo}} 





// 注 染 到 

<a class="navbar-brand" href="/"> 
My Little Community 

</a> 


任何 添加 到 { {#1inkTo}} 块 辅助 函数 的 属性 都 将 被 演 染 到 锚 元 素 。 这 样 ， 你 就 可 以 添加 
性 ， 比 如 class、data-* 或 ig。 


8.3.2 ”让 活动 路 由 有 更 好 的 导航 链接 


为 了 让 用 户 知道 他 们 目前 正在 处 理应 用 的 哪个 部 分 , 你 应 该 突出 显示 与 当前 路 由 相关 联 的 链 
接 。 这 样 ， 用 户 可 以 直接 看 到 他 们 在 应 用 上 的 位 置 (图 8-13 )。 

对 于 这 个 功能 , 你 需要 一 个 可 用 于 任何 模板 和 导航 链接 的 全 局 模板 助手 。 全 局 辅助 函数 的 目 
的 是 检查 当前 活动 的 路 由 是 否 匹 配 链接 的 路 由 。 要 知道 哪些 路 由 当前 处 于 活动 状态 ， 你 将 使 用 
LrOR., Router 的 命名 路 由 功能 : 

Router.route("/about", {name: "about"}); 

每 个 路 由 都 可 以 有 一 个 可 选 的 名 称 ， 这 使 它 更 容易 引用 。 代 码 清单 8-14 定 义 了 一 个 模板 辅助 
函数 ， 用 于 确定 当前 路 由 的 名 称 并 将 其 返回 到 模板 。 在 HTML 文 件 中 可 以 实现 一 个 简单 的 检查 ， 
并 为 当前 路 由 的 1i 元 素 设置 active CSS 类 。 








al 






















































































168 第 8 章 路 由 





活动 链接 被 高 亮 显示 








€ 3 © |D localhost:3000/about 








My Little Community ”About 


About 


图 8-13 ”活动 的 导航 项 目 有 活动 的 CSS 类 和 高 亮 的 UI 





代码 清单 8-14 ”用 于 高 之 显示 一 个 活动 链接 的 全 局 模板 辅助 荫 数 
// helpers.js 
Template.registerHelper("isActiveRoute", function(routeName) { 





if (Routet .current () .route.getName() === routeName) { 
ee active'; < 如 果 当 前 活动 路 由 的 
} ) ; 名 字 等 于 routeName， 
返回 active 
// index.html 了 _ 
<nav> 模板 辅助 函数 以 一 个 
<ul> 路 由 名 称 作为 参数 进 
<11 class="{{isActiveRoute 'about'}}"> 行 检查 
#1inkT te="about"}}About{{/linkT < 一 
inkTo route="about"}}About{{/linkTo}} linkTo 辅 助 函数 为 
A /about 路 由 创建 实际 
</nav> 的 链接 标签 














你 可 以 在 每 个 想 设 置 为 活动 的 导航 链接 上 使 用 这 个 模板 辅助 函数 , 活动 类 取决 于 当前 路 由 的 
名 称 。 也 可 以 将 此 辅助 函数 用 于 任何 需要 检查 当前 活动 路 由 名 称 的 其 他 地 方 。 


8.3.3 ”等待 外 部 库 加 载 


Meteor 在 初始 页 面 请 求 时 会 在 客户 端 加 载 每 个 JavaScript。 如 果 你 的 应 用 包含 很 多 外 部 的 
JavaScript 库 , 那么 不 把 所 有 的 东西 都 放 在 主 应 用 文件 夹 是 一 个 好 主意 , 因为 这 样 做 会 增加 第 一 次 
访问 页 面 时 需要 传输 的 数据 量 , 因而 导致 页 面 加 载 时 间 将 比 静 态 泻 染 的 页 面 长。 如 果 你 需要 使 用 
初始 页 不 需要 的 外 部 库 ， 最 好 将 它们 从 初始 加 载 请 求 中 拆 分 出 来 。 

Iron.Router 使 基于 路 由 来 加 载 外 部 库 成 为 可 能 。 当 添加 一 个 地 图 或 日 期 选择 器 时 , 库 必 须 
在 演 染 之 前 加 载 ， 这 也 可 以 通过 Router 实 现 。 

wait-on-1ipb 包 将 提供 必要 的 功能 : 


$ meteor adqd manuelschoebel:wait-on-1lib 
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这 个 包 使 你 可 以 使 用 一 个 名 为 IRLibloagder 的 对 象 ， 它 可 以 用 于 路 由 中 的 waiton 函 数 ， 就 
像 在 Meteor .subscription 中 那样 。 假 设 你 只 想 为 /profiles/:_iq URL 加 载 jquery.fittext.js 
库 。 一旦 加 载 ， 它 会 使 文本 的 大 小 更 加 灵活 。 该 库 位 于 公用 文件 夹 中 ， 即 public/jquery.fittext.js”。 

有 了 wait-on-1ib 包 ，waiton 限 数 可 以 像 代 码 清 单 8-15 所 示 那 样 使 用 。 你 定义 一 个 完整 的 
URL 或 文件 名 ，wait-on-1ip 将 在 公用 文件 夹 中 查找 文件 。 


代码 清单 8-15 ”等 待 外 部 库 加 载 
// router.js 
Router.route('/profiles/:_id', { 
Yes es 


























waiton: function() { 你 可 以 订阅 发 布 ， 
return [ 就 像 通常 那样 去 做 
Meteor.subscribe('profile', this.params._id) 
nm IRLibLoader.load("/jquery.fittext.js") < 一 IRLibLoader 的 行为 就 像 
一 个 订阅 , 它 还 包括 一 个 
加 载 指示 器 


] ) 

即使 Meteor 被 作为 一 个 完整 的 应 用 加 载 , 你 仍然 可 以 加 载 那些 不 是 应 用 中 每 个 访问 都 需要 的 
库 ， 这 样 可 以 减少 初始 页 面 加 载 时 必须 传输 的 数据 。 

8.3.4 将 路 由 组 织 为 控制 器 


到 现在 为 止 , 你 在 route () 方 法 中 直接 添加 了 所 有 的 路 由 功能 。 如 果 在 一 个 大 型 的 应 用 中 这 
样 做 ，routes.js 文 件 很 快 就 会 变 得 太 大 而 难于 管理 ， 你 不 能 一 眼 快速 了 解 应 用 的 路 由 。 作 为 一 种 
组 织 代码 更 好 的 手段 ， Iron .Router 引 入 了 控制 器 的 概念 ( 见 下 )。 











路 由 控制 器 简介 

许多 Web 框 架 建立 在 MVC 原 则 之 上 ， 它 包括 模型 ( model )、 视 图 ( view ) 和 控制 器 
( controller )。 因 此 ,控制 器 术语 有 很 多 相关 的 内 容 。Meteor 不 依赖 MVC 模 式 ， 这 意味 着 这 些 假 
设 可 能 是 不 准确 的 。 那 么 ， 在 Iron .Router 中 ， 什 么 是 控制 器 ? 

路 由 控制 器 是 常用 共享 路 由 指令 的 蓝图 。 每 个 路 由 可 以 建立 在 这 些 默认 设置 上 , 并 根据 需 
要 进行 扩展 。 从 技术 上 说 ， 路 由 控制 器 是 一 个 对 象 ， 它 在 URL 改 变 时 保存 状态 信息 。 当 应 用 越 
来 越 大 时 ， 控 制 器 主要 提供 了 以 下 两 个 好 处 。 

口 继承 一 一 路 由 控制 器 可 以 建立 在 另 一 个 路 由 控制 器 之 上 ， 用 来 模拟 应 用 的 行为 ， 遵 从 

不 要 重复 你 自己 (Don’trepeat yourself，DRY ) 原则 。 
口 组 织 一 一 将 路 由 逻辑 分 离 到 不 同 的 文件 有 助 于 更 好 地 维护 实际 路 由 和 业务 逻辑 的 结构 。 














Q@ 公用 文件 夹 内 的 所 有 内 容 都 会 被 原样 提供 。 这 意味 着 即使 一 个 JavaScript 文 件 位 于 public 中 ， 它 也 不 会 被 Meteor 缩 
小 ， 即 使 使 用 --proguction 参 数 运行 也 不 例外 。 
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默认 情况 下 ， 所 有 的 路 由 函数 ， 比 如 route() 和 render() ， 依 赖 于 默认 的 Route- 
Controller 对 象 。 





你 可 以 为 每 个 路 由 指定 一 个 控制 器 ， 并 放 在 它 自己 的 文件 中 。 这 样 ， 你 可 以 从 routes.js 文 件 
删除 所 有 逻辑 ， 并 把 它 分 割 到 多 个 文件 ， 类 似 于 处 理 模板 的 方法 。 

比如 说 ， 你 想 为 主页 路 由 使 用 一 个 控制 器 。 它 应 该 等 待 一 个 profiles 集 合 的 订阅 并 设置 数 
据 上 下 文 ， 以 便 所 有 可 用 的 个 人 信息 都 可 在 home 模 板 中 显示 。 

要 为 路 由 指定 一 个 控制 器 , 可 以 显 式 地 将 其 设置 为 一 个 字符 串 或 控制 器 对 象 。 控 制 器 本 身 通 
常 和 路 由 有 相同 的 名 字 ， 并 且 有 后 缀 controller。 你 需要 组 织 你 的 代码 ， 将 每 个 控制 器 放 在 一 
个 专用 的 文件 中 。 对 于 Homecontroller， 你 需要 定义 waiton 、template 和 aata 属 性 ， 如 代 
码 清单 8-16 所 示 。 


代码 清单 8-16 ”使 用 Iron .Router 控 制 器 


// routes.js 
































Router.route('/', { controller: 'HomeController' }); < 一 利用 控制 器 使 

// homeController.js 0 

HomeController = RouteController.extend({ < 一 hk 
waitOn: function () { 


return Meteor.subscribe('profiles'); 


每 个 控制 器 扩展 默认 的 


} RouteController 对 象 


template: 'home', 


data: function () { 
return { 
profiles: ProfilesCollection.find({}, { 
ne 





Routecontroller 可 以 和 route() 有 相同 的 属性 。 这 意味 着 你 也 可 以 创建 自 定 义 的 action 
函数 或 指定 一 个 layoutTemplate。 将 路 由 分 割 到 单独 的 控制 器 中 使 得 routes.js 文 件 简短 而 干净 
( 见 下 面 的 代码 清单 )。 


代码 清单 8-17 ”使 用 控制 咒 的 路 由 声明 

















基本 的 路 由 不 需 
Router.route('/', { controller: 'HomeController' }); 要 控制 器 
Router.route('/about', 'about'); Dn 
Router.route('/profiles/:_id', { controller: 'ProfileController' }); 


如 果 使 用 的 是 命名 路 由 ， 你 甚至 不 必 再 指定 一 个 控制 器 。 如 果 有 一 个 名 为 home 的 路 由 ， 
Iron.Rout r 将 会 自动 寻找 个 名 为 homeController 或 HomeController 的 控制 器 。 下 面 的 
代码 和 代码 清单 8-17 中 的 代码 实现 了 一 样 的 工作 : 
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Router.route('/', { name: 'home' }); 如 果 需 要 , 你 可 

Router.route('/about', { name: 'about' }); 以 将 一 个 名 称 

Router.route('/profiles/:_id', { name: 'profile.details', 和 一 个 控制 器 
controller: “ProfileController'}}; 的 ID 传递 给 路 由 


8.3.5 ”使 用 钧 子 扩展 路 由 过 程 


钩子 基本 上 就 是 一 个 可 以 添加 到 路 由 过 程 中 的 函数 。 使 用 路 由 钩子 最 常见 的 要 求 之 一 是 防止 
匿名 用 户 访问 内 部 路 由 。 另 一 个 用 例 是 跟踪 一 些 统计 或 计数 视图 ,比如 某 个 个 人 信息 被 查看 的 次 
数 。 要 跟踪 每 一 个 视 岁 ， 你 可 以 使 用 onRun 钩 子 。 这 个 钧 子 只 确切 地 运行 一 次 ,不 管 是 否 发 生计 
算 无 效 以 及 重新 运行 等 事件 。 因 此 ，ocnRun 是 用 来 增加 视图 计数 的 完美 钧 子 。 



































Iron.Router 钧 子 
对 于 每 一 个 钩子 ， 你 可 以 创建 一 个 函数 或 多 个 函数 组 成 的 数组 ， 它 们 都 将 会 被 调用 。 
onRun 一 一 当 路 由 第 一 次 运行 时 调用 。 它 只 运行 一 次 1 


onRerun 一 一 每 一 次 计算 无 效 都 会 被 调用 。 

onBeforeAction 在 action 或 oute 函 数 运行 前 调用 。 如 果 有 多 个 函数 ， 你 必须 确 
保 next 被 调用 ， 因 为 在 onBeforeActions 中 下 一 个 函数 的 调用 不 会 自动 发 生 。 如 果 你 想 要 下 
一 个 onBeforeAction 函 数 被 调用 ， 就 必须 调用 Ehis.next。 

onAfterAction 在 action 或 koute 函 数 运行 之 后 调用 。 
如 果 一 个 路 由 停止 ， 比 如 运行 一 个 新 的 路 由 ， 这 个 钩子 将 被 调用 。 











nso 


在 代码 清单 8-18 中 ， 你 添加 了 一 个 onRun 钩 子 到 Profilecontroller。 现 在 ， 每 当 路 由 
被 访问 时 ，Profilescollection 的 一 个 update 都 会 被 执行 ， 它 将 当前 个 人 信息 的 views 字 
段 增 加 1。 


代码 清单 8-18 ”添加 一 个 钧 子 到 RouteController 


// ProfileController.js 

ProfileController = RouteController.extendl(t{ 
layoutTemplate: 'profileLayout', 
template: 'profileDetail', 
yieldTemplates: { 








UR i 
‘profileDetailLeft': {to: 'left'} 这 个 路 由 每 次 运 

} ， 行 时 ， 视 图 属性 

onRun: function() { 2 将 增加 1 


ProfilesCollection.updatel(lt{ 
_id: this.params._id 
je 
Sines 苹 
views: 1 


}) . 使 用 next() 


this.next (); < 一 继续 路 由 
} 





} 9 

现在 ， 每 个 个 人 信息 的 查看 都 被 计算 在 内 ， 你 可 以 在 一 个 个 人 信息 的 数据 上 下 文中 使 用 
{ {views}} 来 添加 它 。 

在 我 们 的 社区 应 用 中 ,， 有 几 个 路 由 只 有 会 员 能 够 访问 。 这 可 以 通过 onBeforeHook 来 方便 地 
实现 。 其 代码 可 参考 代码 清单 8-19。 在 onBeforeaAction 钩 子 内 ， 你 对 当前 用 户 的 ID 进行 检查 。 
如 果 没 有 可 用 的 用 户 ID ， 你 将 把 请 求 重 定向 ， 显 示 一 个 memberson1ly 模 板 。 结 合 对 用 户 ID 进行 
检查 的 数据 发 布 ， 这 将 足以 阻止 用 户 看 到 他 们 没有 被 授权 的 内 容 。 


代码 清单 8-19 ”特定 路 由 需要 用 户 登 录 才 能 访问 
// profileController.js 
ProfileController = RouteController.extend(t{ 




















Uo" el 
onBeforeAction: function() { 
if (!Meteor.userId()) { 
this.render('membersonly'); 
} else { 
this.next (); 
} 
Ey 
AR 


过 
把 这 些 钧 子 放 在 控制 器 中 或 封装 成 插件 可 以 让 它们 可 重复 使 用 。 





8.3.6 创建 Iron.Routezt 插件 


如 果 你 想 创 建 一 个 用 于 多 个 应 用 或 可 在 社区 共享 的 钩子 ， 那 么 创建 Iron .Routezr 捅 件 将 是 
正确 的 作法 。 这 些 插件 使 得 一 些 易于 移植 的 功能 很 容易 共享 ， 并 可 在 应 用 和 包 中 使 用 。 让 我 们 把 
需要 用 户 登 录 的 钩子 变 成 一 个 插件 。 

每 个 Iron .Route 插件 都 可 以 作为 配置 的 一 部 分 添加 。 你 可 以 在 所 有 的 或 某 些 特定 的 路 由 
中 包含 它 。 因 为 在 /profiles 路 由 中 已 经 有 了 一 个 onBeforeAction 钩 子 , 所 以 你 可 以 把 代码 从 
这 里 移动 到 一 个 新 的 router/plugins/membersOnlyjs 文 件 中 。 创 建 一 个 插件 类 似 于 定义 模板 辅助 函 
数 的 方式 。 插 件 有 两 个 参数 : router 和 options。 插 件 不 是 简单 地 读 取 传递 给 它 的 参数 ， 它 使 
用 1ookupoption 函 数 来 访问 Iron.Router 中 所 有 可 用 的 配置 选项 。 你 可 以 按照 这 里 访问 
membersonlyTpl 设 置 的 方式 , 使 用 该 函数 访问 layoutTemplate。 正 如 代码 清单 8-20 所 示 , 插 
件 的 大 部 分 代码 与 实际 路 由 相当 类 似 。 

要 使 用 插件 ， 你 不 会 从 一 个 特定 的 路 由 或 控制 器 来 调用 它 ， 而 是 在 路 由 配置 文件 
router/config.js 中 设置 它 ( 见 代码 清单 8-20 )。 插件 通过 Router .plugin('name' ,options) 来 加 
载 。 这 个 options 对 象 包含 两 个 设置 : membersonlyTpl， 当 一 个 匿名 用 户 试 图 访问 需要 用 户 ID 
的 路 由 时 ， 它 定义 需要 演 染 的 模板 ; only 设 置 包含 一 个 受 影响 的 路 由 数组 。 你 有 一 个 需要 保护 
的 路 由 /profile。 如 果 你 的 大 多 数 路 由 都 需要 一 个 插件 ， 那 么 你 可 以 使 用 except 而 不 是 only 
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来 定义 不 需要 用 户 登 录 的 所 有 路 由 。 





代码 清单 8-20 ”创建 一 个 可 重用 的 Iron .Routezt 插 件 


该 插件 名 为 
membersonly 它 作为 一 个 
// membersOnly.js onBeforeActio 
Iron.Router.plugins.membersOnly = function(router, options) { 钩子 运行 
router.onBeforeAction(function() { < 
if (!Meteor.userId()) { 
this.render (this.lookupOption('membersOnlyTpl1')); <— this.lookupOption 
} else { 也 可 以 访问 
this.next (); < 一 继续 ， 如 果 有 Router.configure() 
} 用 户 ID 设置 的 全 局 选项 
}, options); 
} 
A 用 户 没 有 登录 的 
7 ORES 情况 下 ， 应 该 演 
Router.plugin('membersOnly', { 染 的 模板 


membersOnlyTpl: 'membersonly', 
only: ['profile.details'] 
7 


请 记 住 ,此 插件 仅 在 客户 端 检 查 用 户 ID。 























<“ |] 该 插件 只 适用 于 


profile.details 路 由 








n 


任何 恶意 用 户 都 可 以 伪造 一 个 用 户 ID , 所 以 依靠 路 


由 功能 作为 唯一 的 安全 措施 是 不 够 的 。 应 该 在 使 用 路 由 的 同时 ， 在 服务 器 端的 发 布 中 对 用 户 ID 
进行 检查 , 这 样 才 可 以 确保 你 的 应 用 在 生产 环境 中 是 安全 的 。 即 使 用 户 可 以 得 到 单个 个 人 信息 的 
布局 和 模板 ， 他 们 仍然 无 法 访问 任何 数据 ， 因 为 数据 没有 首先 发 布 到 客户 端 。 











8.4 用 于 REST API 的 服务 器 端 


如 果 你 需要 非 Meteor 客 户 端的 API 就 不 能 




















服务 器 上 ， 因 为 你 面 对 的 是 一 个 愚蠢 的 客户 端 ， 














路 由 


使 用 DDP， 所 以 你 可 能 需要 一 个 传统 的 HTTP 接口 。 
在 一 个 自动 化 的 过 程 中 , 你 可 能 想 让 脚本 来 基于 ID 查找 他 们 的 用 户 名 。 这 样 所 有 的 路 由 都 发 生 在 





它 只 知道 一 个 URL。 如 果 客 户 端 需要 的 只 是 














名 字 字 符 串 ， 那 就 没有 必要 首先 发 送 所 有 JavaScript 过 去 。 
服务 器 端 路 由 的 实现 需要 为 route () 孙 数 传递 where 选 项 。 你 使 用 此 选项 来 限制 路 由 仅 在 服 





务 器 端 使 用 。 要 提供 HTTP 接 口 来 有 效 地 绕 过 大 多 数 Meteor 的 功能 ， 








全 


你 可 以 依靠 Node.js 的 基本 功 


能 ， 即 request 和 response 对 象 ( 见 代码 清单 8-21 )。 无 需 定 义 所 有 的 头 ， 也 无 需 使 用 
response.write(), 你 的 代码 短 到 只 使 用 了 response.end()。 在 response.end() 国 数 中 ， 











你 使 用 给 定 的 ID 进 行 数据 库 查 询 并 返回 name 





属性 〈 





图 8-14 )。 


© © © / 门 localhost3000/apyprofies x 





€ SC ( localhost:3000/api/profiles/name/ardteCGap4JHNn6Mjw 





Manuel 


图 8-14 ” 当 给 定 一 个 有 效 的 人 DD 时 ， 该 接口 的 响应 为 成 员 的 名 称 
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、 < Ml A 
代码 清单 8-21 ”服务 器 端的 简单 路 由 
Router.route('/api/profiles/name/:_id', function() { Node.js 的 请 求 对 象 
Var request = this.request; < 一 
和 his. 了 
Var response this.response 33] Node js 的 响应 对 象 
response.end (ProfilesCollection.findonel({ 
_id: this.params._id 


}) .name); 此 路 由 应 该 只 在 服务 器 上 
Lt 运行 , 而 不 应 在 客户 端 上 运 
where: 'server' 二 _ 行 


}) 

如 果 你 发 出 一 个 请 求 ， 以 查询 字符 串 和 消息 为 关键 字 ， 服 务 器 将 返回 相关 的 值 。 

对 于 更 高 级 的 应 用 ， 甚 至 可 以 使 用 route () 函数 来 确定 是 否 收 到 了 GET 、POST 或 PUT 请 求 。 
对 于 更 多 的 RESTful 路 由 ， 可 以 看 看 代码 清单 8-22。 它 为 /api/find/profiles 定 义 了 一 个 GET 
方法 ， 从 个 人 信息 集合 中 返回 所 有 的 数据 库 记 录 ; 它 也 为 /apiy/insert/profile 定 义 了 一 个 
POST 方法 ， 用 于 通过 APrI 来 创建 一 个 新 的 个 人 信息 。 请 记 住 ， 当 把 这 个 用 于 自己 的 API 时 ， 为 确 
保 API 的 安全 ， 你 需要 一 个 登录 系统 。 


代码 清单 8-22 ”RESTful 路 由 






































ee 这 是 仅 在 服务 器 端 
Router.route('/api/find/profiles', { | 使 用 的 路 由 
Where: “SerVer 
定义 GET 请 求 需要 
.get (function() { 4 做 什么 
this.response.statusCode = 200; 
this.response.setHeader ("Content-Type", "application/json"); 
this.response.setHeader ("Access-Control-Allow-Origin", "*"),，; 
this.response.setHeader ("Access-Control-Allow-Headers", 
"Origin, X-Requested-With, Content-Type, Accept"); 
this.response.end(JSON.stringify!l( ~ 
Profilescollection.find().fetch()) 所 有 REST 响 应 都 应 该 
Ds 是 JSON 格 式 的 
} 
Router.route('/api/insert/profile', { 
where: 'server 这 是 仅 在 服务 器 端 
| 使 用 的 路 由 
.post (function() { 
this.response.statusCode = 200; 
定义 POST this.response.setHeader ("Content-Type", "application/json"); 
请 求 需要 做 this.response.setHeader ("Access-Control-Allow-Origin", "*"),; 
什么 this.response.setHeader ("Access-Control-Allow-Headers", 
"Origin, X-Requested-With, Content-Type, Accept"); 
// 为 新 人 的 个 人 信息 返回 ID 








this.response.end(JSON.stringify!( < 一 所 有 REST 响 应 都 应 该 
汪 SO es elie insert (this.request .body) 是 JSON 格 式 的 
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提示 如 果 你 需要 建立 一 个 REST 接 口 ,不 要 直接 使 用 Iron .Router， 你 应 该 考虑 使 用 nimble: 
restivus 或 simple:rest 包 ， 它 们 都 提供 了 一 个 更 简单 的 方法 来 创建 路 由 和 服务 端点 。 








Iron.Router 是 一 个 非常 灵活 、 高 度 可 配置 的 路 由 器 ,是 专 为 Meteor 平 台 打造 的 。 它 使 应 用 
能 够 在 特定 的 路 由 请 求 上 作出 反应 ， 也 可 以 用 于 很 好 地 优化 代码 结构 。 


8.5 总 结 


在 本 章 中 ， 你 已 经 了 解 到 : 

口 URL 使 应 用 可 以 访问 和 共享 ; 

口 Iron.Router 是 Meteor 中 路 由 的 事实 标准 ; 

口 可 以 使 用 路 由 定义 模板 、 订 阅 和 数据 上 下 文 ; 

口 路 由 功能 可 以 通过 使 用 命名 路 由 、 控 制 器 、 钩 子 和 插件 来 结构 化 和 分 组 ; 
口 可 以 为 客户 端 和 服务 器 创建 路 由 。 























包 








本 章 内 容 

口 查找 并 添加 核心 和 社区 包 
口 整合 npm 包 

口 编写 、 测 试 和 发 布 自 定 义 包 








活跃 的 包 生 态 系 统 是 Meteor 最 强大 的 一 个 方面 。 包 的 使 用 贯穿 本 书 , 我 们 利用 包 扩 展 应 用 的 
功能 只 需要 几 行 代码 ( 例如 使 用 twbs :bootstrap 或 iron:router )， 也 通过 包 操 作 删 除 不 需要 
的 功能 (例如 使 用 autopublish 和 insecure )。 本 章 将 仔细 看 看 Meteor 可 以 使 用 什么 类 型 的 包 
以 及 它们 如 何 一 起 工作 。 

在 一 个 系统 中 , 涉及 的 组 件 越 多 , 要 考虑 的 所 有 组 件 的 依赖 关系 就 越 复 杂 。 使 用 第 三 方 库 时 ， 
调用 一 组 已 知 的 API 是 很 重要 的 。 在 最 坏 的 情况 下 ， 第 三 方 库 会 在 不 同 版 本 之 间 改 变 接口 ， 这 将 
导致 应 用 中 的 小 部 分 更 新 , 可 能 会 破坏 整个 应 用 的 功能 。 包 管理 器 可 识别 应 用 中 各 部 分 之 间 的 依 
赖 关 系 。 它 们 的 工作 也 包括 将 可 能 的 不 兼容 尽 可 能 降 到 最 低 ， 这样， 部 分 的 改变 不 会 意外 地 破坏 
某 块 代码 。 

读 完 这 一 章 ， 你 将 能 够 使 用 现 有 的 包 ， 也 能 够 创建 自己 的 包 ， 从 而 以 更 有 效 的 方式 来 构建 
Meteor 应 用 。 


9.1 所 有 应 用 的 基础 


你 在 Meteor 中 创建 的 所 有 应 用 , 包括 最 简单 的 “Hello World” 示 例 , 都 已 经 依赖 于 几 十 个 包 。 
这 些 包 是 Meteor 的 组 成 部 分 ， 没 有 它们 ，Meteor 就 只 剩 下 纯粹 的 Node.js。 虽 然 你 可 以 用 那 种 方式 
写 出 惊人 的 应 用 , 但 包 系 统 可 以 让 你 更 容易 、 更 快 地 实现 结果 ， 就 像 站 在 巨人 的 肩膀 上 。 这 就 像 
使 用 普通 的 JavaScript 而 不 是 jQuery 来 访问 DOM， 它 可 以 工作 ， 但 它 需 要 你 付出 更 多 的 努力 ， 而 
这 些 努 力 如 果 用 于 增强 其 他 功能 会 更 好 。 

应 用 由 业务 逻辑 和 许多 提供 功能 的 基本 包 组 成 (参见 图 9-1 )。 
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Blaze cordova 相 机 插件 
Tracker cordova 电 池 插 件 
包 是 构建 所 有 
应 用 的 基础 





Livequery 
全 栈 的 数据 库 驱 动 











图 9-1 在 Meteor 应 用 中 ， 包 是 所 有 业务 逻辑 的 基础 


包 可 分 为 三 种 类 型 ; 
口 Isopack 包 ， 这 是 Meteor 自 己 的 包 格式 ; 
口 Cordova 包 ， 提 供 移动 功能 ; 
口 NPM 包 ， 它 是 Node.js 封 装 的 模块 。 

Isopack 是 Meteor 自 己 的 包 格 式 ， 这 将 是 本 章 的 重点 。 我 们 也 将 看 看 如 何以 包 的 形式 整合 npm 
模块 。 如 果 想 找到 更 多 关于 使 用 Cordova 包 的 内 容 ， 可 以 跳 到 第 11 章 ， 在 那里 我 们 将 详细 讨论 移 
动 应 用 和 包 。 





9.2 使 用 lsopack 


因为 它们 的 同 构 性 ，Meteor 包 被 称 为 Isopack 包 ”。 与 npm 模 块 比 起 来 ， 它 们 不 局 限于 服务 器 ， 
它们 可 以 应 用 于 服务 器 、 浏 览 器 甚至 是 移动 端 代码 。 它 们 提供 单一 的 接口 ， 而 基于 特定 架构 的 功 
能 对 用 户 是 不 可 见 的 。 例 如 ，HTTP.get () 函数 可 以 在 代码 中 的 任何 地 方 调用 。 从 技术 上 讲 ， 它 
在 服务 器 上 和 浏览 器 上 应 该 有 不 同 的 实现 。 因 此 ， 这 个 提供 了 HTTP 功 能 的 http 包 ， 在 浏览 器 环 
境 使 用 xMLHttpRequest ， 而 在 Node.js 环 境 中 则 使 用 http.request。 

Isopack 并 不 限于 JavaScript 代 码 ， 它 们 还 可 以 包括 样式 、 模 板 (例如 ， 在 accounts-ui 包 中 
包含 登录 对 话 框 )， 其 至 静态 资源 ， 如 图 像 或 字体 。 有 些 包 也 可 以 修改 构建 过 程 ， 比 如 支持 
CoffeeScript 或 LESS 样 式 。 我 们 讨论 Isobuild (第 11 章 ) 时 会 仔细 介绍 这 些 包 。 








GD Isopack 是 isomorphic package ( 同 构 包 ) 的 简写 。 一 一 译 者 注 
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9.2.1 版 本 求解 器 和 有 语义 的 版 本 号 





Isopack 很 少 独 立 存 在 , 它们 通常 会 依赖 于 其 他 的 包 。 这 样 避 免 了 代码 的 重复 , 但 需要 一 个 复 
杂 的 方法 来 确定 哪些 包 可 以 很 好 地 在 一 起 工作 。Meteor 版 本 求解 器 (Meteor Version Solver ) 是 包 
依赖 关系 的 优化 约束 求解 器 。 它 超越 了 简单 的 约束 求解 ， 因 为 它 不 是 去 找 一 个 可 能 的 解决 方案 ， 
它 的 目标 是 去 找 最 好 的 解决 方案 。 

一 个 可 工作 应 用 的 任何 更 新 都 有 破坏 现 有 功能 的 风险 。 添加 新 的 包 也 一 样 , 这 就 是 为 什么 版 
本 求解 器 在 添加 新 包 时 试图 维持 现 有 的 包 版 本 。 如 果 这 是 不 可 能 的 , 它 就 会 去 寻找 一 个 解决 方案 ， 
其 中 只 改变 该 包 的 直接 依赖 关系 ， 基 于 新 的 API 进 行 向 后 兼容 的 升级 。 版 本 求解 器 采用 某 些 解决 
方案 而 不 是 一 个 可 能 的 方案 ， 这 使 它 成 为 一 个 优化 的 约束 求解 器 。 

所 有 的 Isopack 包 都 遵循 语义 版 本 规则 ， 这 使 版 本 求解 右 能 够 确定 引入 一 个 包 是 否 是 破坏 性 
的 。 所 有 为 其 他 包 提 供 公 共 接 口 的 包 ， 其 版 本 号 都 由 三 个 部 分 组 成 : 


MAJOR .MINOR .PATCH 


































































































语义 版 本 

版 本 号 必须 使 用 语义 版 本 号 。 这 基本 上 意味 着 你 必需 使 用 三 个 数字 , 其间 用 点 分 开 ， 比如 
es 和 天色 于 让 

第 一 个 数字 是 主要 版 本 号 。 如 果 包 的 变化 显著 ， 包 含 不 兼容 的 API 变 化 ， 你 就 需要 增加 这 
个 数字 。 这 给 使 用 这 个 包 的 开发 人 员 一 个 信号 :“ 如 果 从 版 本 1.x.x 更 新 到 2.x.x， 必 须 修改 
代码 ， 使 用 新 的 API。” 

增加 第 二 个 数字 的 情况 是 ， 包 中 增加 了 新 的 功能 ， 但 是 没有 破坏 性 的 变化 。 这 样 ， 使 用 该 
包 的 开发 人 员 知 道 他 可 以 从 版 本 1.2.x 更 新 到 1.3.x,， 并 且 应 用 可 继续 运行 。 他 可 以 决定 新 的 
功能 是 否 对 他 有 用 ， 并 在 必要 时 使 用 它 。 

第 三 个 数字 是 补丁 版 本 号 ， 增 加 它 的 情况 是 修复 了 包 中 的 错误 但 不 破坏 任何 API。 使 用 这 
个 包 的 开发 人 员 几 乎 总 是 要 更 新 到 这 种 版 本 ,因为 这 样 包 将 更 稳定 , 而 且 不 会 破坏 应 用 中 的 任 
何 东 西 。 

你 可 以 在 http://semver.org/ 阅 读 更 多 关于 语义 版 本 的 内 容 。 


在 处 理 包 约束 时 ， 开 发 人 员 现 在 可 以 采取 下 面 的 某 种 方法 : 
D 一 个 包 需 要 某 个 确切 的 版 本 ; 
口 一 个 包 需 要 某 个 最 低 版 本 ; 
D 一 个 包 需 要 某 个 确切 的 版 本 或 最 低 版 本 。 

这 将 给 版 本 求解 器 设 定 各 种 选项 , 让 它 确定 最 佳 的 包 组 合 。 当 一 个 包 需 要 的 最 低 版 本 是 2.0.0 
版 本 ， 任 何以 2 打头 的 版 本 都 将 是 有 效 的 选择 ， 因 为 所 有 的 版 本 共享 相同 的 特征 集 。 但 如 果 一 个 
包 最 低 需 要 2.2.0 版 本 ， 则 只 有 更 高 的 版 本 号 是 可 以 接受 的 选择 ， 因 为 在 增加 一 个 次 要 版 本 号 时 ， 
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它 有 可 能 引入 新 的 功能 ， 只 要 现 有 的 功能 和 API 仍 然 可 用 就 可 以 。 需 要 某 个 包 的 2.x.y 版 本 时 ， 可 
能 3.x.y 也 能 工作 。 但 版 本 求解 器 在 约束 求解 时 不 会 考虑 更 高 (或 更 低 ) 的 主要 版 本 号 。 当 我 们 向 
你 展示 如 何 逐 步 开 发 自己 的 包 时 ， 你 将 了 解 更 多 关于 版 本 定义 的 知识 。 

请 记 住 ，Meteor 不 像 Nodejs， 它 的 每 个 应 用 只 支持 单一 版 本 的 包 ， 这 是 很 重要 的 。 它 不 可 能 
安装 同一 个 包 的 不 同 版 本 ， 比 如 jquery 或 http 包 。 昌 然 它 可 以 在 服务 右上 工作 ,但 这 种 方法 在 
客户 端 上 将 导致 不 可 预知 的 行为 。 因 此 , 约束 解析 器 必须 总 是 返回 包 的 一 个 满足 所 有 要 求 的 版 本 。 


9.2.2 ”查找 包 


Meteor 开 发 小 组 维护 着 一 个 公共 的 包 服务 器 , 其 中 保存 了 所 有 可 用 的 Isopack。 这 个 包 服务 器 
是 一 个 DDP 服 务 ， 可 以 通过 packages.meteor.com 来 访问 。 你 可 以 建立 自己 的 客户 端 来 搜索 包 ， 但 
最 好 的 方法 是 通过 CLI 工 具 。 一 个 更 方便 的 方法 是 使 用 Web 界 面 https://atmospherejs.com。 包 服务 
器 中 包含 Meteor 开 发 小 组 开发 的 核心 包 ， 也 包含 由 其 他 组 织 或 个 人 开发 的 社区 包 。 

1. Isopack 的 类 型 

Isopack 有 两 级 命名 空间 。 大 和 多数 包 都 有 一 个 前 级 ( 如 twbs 或 iron ) 用 于 标识 维护 者 。 这 些 
都 是 社区 包 。 没 有 前 级 的 Isopack 是 由 Meteor 开 发 小 组 开发 的 ， 被 认为 是 核心 包 。 
核心 包 由 Meteor 开 发 小 组 本 身 创建 和 维护 ,如 果 你 新 建 一 个 Meteor 项 目 , 你 会 立即 添加 Meteor 
的 很 多 核心 包 , 虽然 只 有 三 个 包 被 显 式 添加 , 但 其 余 的 包 都 是 这 三 个 包 所 依赖 的 。 这 三 个 包 分 别 
如 下 。 


口 metero-platform 
























































































































































大 概 有 近 50 个 包 的 库 , 包括 跟踪 器 ( Tracker )、Blaze 、Minimongo 
和 jQuery 。 要 查看 所 有 包含 在 meteor-platform 中 的 包 ， 可 以 运行 meteor show 
meteor-pP1latformo 

DQ autopublish 自动 发 布 所 有 集合 。 

DQ insecure 人 允许 从 客户 端 写 入 数据 库 。 

要 查看 Meteor 开 发 小 组 维护 的 所 有 包 , 可 以 使 用 命令 行 工具 进行 搜索 。 确 保 不 要 忘记 搜索 命 

令 最 后 的 点 号 ， 它 将 显示 所 有 的 包 : 

$ meteor search --maintainer=mdg . 

你 可 以 通过 $ meteor add package 添 加 核心 包 。 

一 个 包 有 前 级 , 这 一 事实 并 不 包含 任何 关于 其 稳定 性 或 可 接受 程度 的 信息 , 它 只 是 说 明了 谁 
负责 处 理 可 能 出 现 的 问题 。 





















































说 明 一 些 包 有 mrt: 前 级 ， 这 表明 它们 已 经 被 自动 迁移 到 Meteor 0.9.0 新 引入 的 包 系 统 。 它 们 可 
能 不 再 被 积极 维护 了 。 使 用 这 些 包 时 要 小 心 。 


2. 通过 命令 行 工 具 搜索 包 
使 用 meteor 命 令 行 工 具 , 你 可 以 直接 访问 包 库 并 进行 搜索 。 使 用 search 命 令 可 以 在 包 名 中 
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包 





查找 任何 字符 串 ， 例 如 ，dap: 


$ meteor search ddp 


搜索 返回 的 10 个 包 显 示 在 图 9-2 中 。 





社区 包 








MacBook:~ stephans$ teor search ddp 
Matching packages; 





CollectionFS, DDP File Upload 
Meteor's latency-compensated distributed data framework 








deanius:debug-ddp Shows all of your DDP Messages in your browser console. 


flyandi:eventddp A server and client event package, events via ddp. 

gwendall: remote-ddp Get your client point to any DDP server 

hb5:drupal-ddp Drupal and Meteor integration over DDP 

jaspertu:accounts-facebook-ddp | Login service for Facebook accounts 

jasperlu:facebook-ddp Facebook OAuth flow to include mobile ddp clients 

lai:ddp-inspector See all DDP activity in the client-side and full-text search thenm. 
ongoworks:ddp-login Securely log in to a non-primary DDP connection from another browser or server 
raix:eventddp A server and client event package, events via ddp. 








You can use 'meteor show ‘to get more information on a Specific item. 
MacBook:~ stephan$ 目 








正如 你 看 到 的 ， 


社区 包 
图 9-2 使 用 CLI 工 具 在 包 库 中 搜索 dap 


吉 果 集合 中 列 出 了 多 个 包 ， 其 中 一 个 是 名 为 adp 的 核心 包 。 其 他 包 是 以 创建 








包 的 组 织 的 名 称 开 始 的 社区 包 。 








search 命 令 只 列 出 了 一 些 简 要 的 信息 ， 总 结 了 一 个 包 是 做 什么 的 。 要 查看 某 个 包 的 详细 信 


息 » 可 使 用 show 命 令 。 寺 


图 9-3 )。 





其 输出 包括 包 的 自述 文件 (README ) 内 容 以 及 现 有 版 本 的 列表 ( 参见 


MacBook:~ stephan$ meteor show ddp 
Package: ddp@1.1.0 

Maintainers: mdg 

Exports: DDP, DDPServer (server) 


DDP (Distributed Data Protocol) is the stateful websocket protocol 

that Meteor uses to communicate between the client and the server. For 

more information about DDP, see the [DDP project 

page] (https://ww.meteor.com/ddp) or the [DDP 

specification] (https://github.com/meteor/meteor/blob/devel/packages/ddp/DDP.md). 


This package is used by nearly every Meteor application and provides a 
full implementation of DDP in JavaScript. API documentation is on the 
[main Meteor documentation page] (http://docs.meteor.com/), under 
"Publish and subscribe", "Methods", and "Server connections". Note in 
particular that clients can use 

[DDP.connect“] (http://docs.meteor.com/#ddp_connect) to open a DDP 
connection to any DDP service on the Internet. 


Recent versions: 
1.0.11 0ctober 28th, 2014 installed 
1.0.12 December 9th, 2014 installed 
1.0.13 December 1i9th, 2014 installed 
:0.14 January 20th，2015 installed 
1.0 March 17th, 2015 installed 


Older and pre-release versions of ddp have been hidden. To see all 54 versions, run 
"meteor show ——show-all ddp'. 
MacBook:~ stephans 目 

















图 9-3 Meteor 的 snow 命令 显示 了 包 的 自述 文件 内 容 和 可 用 版 本 
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3. 在 atmospherejs.com 搜 索 包 
atmospherejs.com 是 Meteor 包 服务 器 的 客户 端 , 由 Percolate 工 作 室 开 发 。 它 使 用 一 个 独特 的 用 
户 界 面 来 搜索 包 。 与 命令 行 工 具 不 同 , 它 不 仅 可 以 搜索 匹配 的 包 的 名 字 , 也 可 以 搜索 自述 文件 的 



































内 容 。 因 此 ， 在 atmospherejs.com 搜 索 aaqp 将 返回 23 个 而 不 是 10 个 结果 ( 参见 图 9-4 )。 


meteorhacks:fast- 
render 
Render your app before the DDP 


connection even comes alive - 
magic? 


@27.5K 请 125 


cfs:access-point 


CollectionFS, add ddp and http 
accesspoint capability 


@ 756 


settinghead:auto- 
nprogress 
A Meteor package that 


automatically shows a 
NProgress.js bar during DDP 


@914 贸 14 


zacharynevin :token- 
auth 


Token authentication over DDP 


©428 令 2 


ostrio:files 


Upload, Store and Download 
small and huge files to/from file 
system (FS) via DDP and HTTP 


®@56 宣 8 


hb5:drupal-ddp 


Drupal and Meteor integration 
over DDP 


©O12 负 4 





图 9-4 


SEARCH PACKAGES 


op 


26 PACKAGES 





mongo 


Adaptor for using MongoDB and 
Minimongo over DDP 


@34K 育 6 


jasperlu:accounts- 
facebook-ddp 


Login service for Facebook 
accounts 


四 59 


ongoworks:ddp- 
togin 
Securely log in toanon-primary 


DDP connection from another 
browser or server 


四 55 负 5 


ddp 


Meteor's latency-compensated 
distributed data framework 


©990 7 


lai:ddp-inspector 


See all DDP activity in the client- 


side and full-text search them. 


四 85 贸 7 


raix:eventddp 


A server and client event 
package, events via ddp. 


四 8 和 2 


在 atmospherejs.com 搜 索 aqp 


livedata 


Moved to the 'ddp' package 


@719 


slava:redis-livedata 


Adaptor for using Redis and 
Miniredis over DDP 


四 166 宣 18 


deanius:debug-ddp 


Shows all of your DDP Messages 
in your browser console. 


@I17 寓 6 


使 用 Web 界 面 还 有 一 个 显著 的 优势 : 每 个 包 都 有 一 个 受 欢 迎 程度 的 指标 ， 它 的 计算 根据 的 是 
包 被 更 新 的 频率 以 及 有 多 少 用 户 下 载 包 。 此 外 , 也 可 以 为 包 点 赞 ( 添加 星星 ) 以 显示 它们 很 有 用 。 
特别 地 ， 当 有 大 量 包 做 类 似 的 事情 时 , 这 个 受 欢迎 的 指标 对 于 在 两 个 或 多 个 包 中 选用 一 个 时 有 很 
大 帮助 。 另 外 ， 每 个 包 的 详细 信息 页 有 两 个 链接 : 一 个 是 相关 的 GitHub 库 ， 男 一 个 是 错误 报告 。 



































Meteor 平 台 上 有 成 千 上 万 的 包 可 用 ,这 样 就 很 难 发 现 新 的 包 。 但 有 一 些 包 在 很 短 的 时 间 内 
就 会 很 流行 ， 所 有 的 Meteor 开 发 者 都 应 该 知道 它们 。 
提供 基于 角色 的 授权 。 
可 以 让 你 轻松 创建 表单 ， 可 以 自动 插入 和 更 新 ， 以 及 提供 自 





| lannmind icles 





D aldeed:autoform 


动 的 响应 式 验证 。 
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口 aldeed:collection2 一 一 在 客户 端 和 服务 器 上 提供 插入 和 更 新 操作 的 自动 验证 。 

提供 了 一 个 统一 的 用 户头 像 模 板 ( Twitter、Facebook、Gravatar 等 )。 

包含 一 个 用 于 Meteor 的 文件 管理 系统 。 

口 ecwyne:polymer-elements 让 你 可 以 把 聚合 元 素 添 加 到 Meteor。 

让 你 可 以 在 应 用 中 添加 路 由 。 

口 meteoric:ionic 一 一 为 Meteor 提 供 了 离子 用 户 界 面 组 件 (Tonic UI components ) 的 移 
植 ， 其 中 不 需要 Angular。 


meLeeonSeeonme sor olen 





口 bengott :avatar 





ee ner eka 








TEoOnt one 








允许 你 在 Meteor 中 使 用 PostgreSQL 数 据 库 。 
在 开发 过 程 中 提供 了 一 个 方便 的 方法 来 检查 集合 内 容 。 
numtel:mysql 一 一 在 你 的 应 用 中 添加 MySQL 支 持 ， 并 带 有 响应 式 SELECT 订 阅 。 
ongoworks:security 一 一 为 面向 客户 端的 MongoDB 集 合 操 作 实 现 了 逻辑 安全 。 
splendido:accounts-melgd 一 一 链接 米 自 不 同 OAuth 提 供 者 的 账户 到 同一 个 用 户 。 
为 应 用 增加 了 本 地 化 /国际 化 支持 。 





ms ena one 








回国 可 | 辐 国 回 








alge 


9.2.3 ”添加 和 删除 lsopack 

在 这 本 书 中 , 你 已 经 添加 和 删除 包 好 几 次 了 ， 所 以 我 们 现在 专注 于 处 理 特定 的 版 本 。 添 加 一 
个 包 最 新 、 最 好 的 版 本 ,使 用 meteor add。 要 添加 Twitter Bootstrap， 使 用 以 下 命令 : 

$ meteor adgd twbs:bootstrap 

如 果 你 想 使 用 一 个 特定 的 版 本 ， 如 v3.3.2， 可 以 使 用 e@= 操 作 符 : 


$ meteor adgqd twbs:bootstrap@=3.3.2 


检查 一 下 .meteor/packages 文 件 。 现 在, 你 将 看 到 其 中 不 仅 列 出 了 包 的 名 称 ， 也 列 出 了 版 本 约 
束 (参见 图 9-5 )。 即 使 有 更 新 的 版 本 ， 它 也 不 会 考虑 ， 因 为 这 个 项 目 固定 使 用 v3.3.2 版 本 。 


MacBook:packagesApp stephans meteor add twbs:bootstrap@=3.3.2 


























Changes to your project's package version selections: 


twbs:bootstrap added, version 3.3.2 


twbs:bootstrap: Bootstrap (official): the most popular HTML/CSS/JS framework 
for responsive, mobile first projects 

MacBook:packagesApp stephan$ cat .meteor/packages 

# Meteor packages used by this project, one per Line。 

# Check this file (and the other files in this directory) into your repository. 
杂 

# 'meteor add' and 'meteor remove' will edit this file for you, 

# but you can also edit it by hand. 


meteor-platform 

autopublish 

insecure 

twbs:bootstrap@=3.3.2 
MacBook:packagesApp stephans 目 


图 9-5 在 项 目 中 添加 一 个 包 的 特定 版 本 
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很 遗憾 ， 这 让 版 本 求解 器 几乎 没有 什么 选择 ， 我 们 仅 应 在 少数 情况 下 才 需 添加 包 的 特定 版 
本 ,例如 ， 当 你 试图 解决 与 某 些 包 联 合 使 用 的 问题 时 。 否则 ,通常 最 好 还 是 定义 一 个 最 小 版 本 。 
定义 一 个 最 小 版 本 ， 使 用 e: 


$ meteor adqq twbs:bootstrap@3.3.2 


此 代码 告诉 版 本 求解 器 总 是 使 用 Twitter Bootstrap 包 的 版 本 3， 但 不 能 低 于 3.3.2。 

Twitter Bootstrap 包 是 一 个 相当 简单 的 包 , 在 项 目 中 添加 它 时 不 会 引入 额外 的 依赖 关系 。 如 果 
你 使 用 更 复杂 的 Isopack， 如 Iron:Router, 一 些 被 依赖 的 包 将 被 添加 到 项 目 中 。 这 些 依 赖 关 系 
是 会 传递 的 , 这 意味 着 开发 人 员 没 有 明确 地 添加 它们 , 但 是 某 个 包 却 要 求 添加 它们 。 确定 和 解决 
这 些 依 赖 关系 是 包 管 理 器 的 工作 。Meteor 会 在 幕后 处 理 这 些 依 赖 关系 的 传递 。 

删除 一 个 包 不 需要 任何 版 本 信息 ， 使 用 包 的 名 称 就 够 了 : 


$ meteor remove twbs:bootstrap 
如 果 包 带 有 传递 的 依赖 性 , 删除 它 的 同时 , 那些 在 剩 下 的 Isopack 中 不 直接 需要 也 不 被 依赖 的 
包 ， 也 会 被 删除 。 













































































9.2.4 更 新 包 


每 次 在 项 目 文件 夹 中 发 出 update 命 令 ， 版 本 求解 器 就 会 自动 确定 是 否 有 必要 更 新 什么 包 。 
昌 然 版 本 求解 器 在 添加 新 的 包 时 会 进行 保守 的 操作 , 试图 避免 任何 更 新 , 但 update 命 令 告诉 它 ， 
它 的 目标 是 最 新 的 可 用 版 本 : 

$ meteor update 

update 命 令 的 默认 行为 是 查找 新 发 布 的 Meteor 并 更 新 核心 包 , 但 有 时 这 可 能 是 不 需要 的 ， 
比如 你 正在 修复 一 个 错误 的 时 候 。 通过 向 命令 提供 一 个 包 名 ,可 以 将 其 操作 限制 在 一 个 包 上 。 要 
更 新 项 目 中 的 所 有 社区 包 ， 使 用--packages-only 参 数 : 


$ meteor update --packages-only 


为 所 有 的 核心 包 都 会 和 某 个 Meteor 发 布 绑 定 ， 所 以 它们 不 会 被 这 个 命令 更 新 。 


9.3 使 用 npm 包 


Meteor 是 建立 在 Node.js 之 上 的 ， 因 此 也 可 以 使 用 所 有 的 Node.js 包 。npm 管 理 这 些 包 ， 它 的 存 
储 库 中 有 超过 100 000 个 包 。 庞 大 的 JavaScript 开 发 社区 为 几乎 所 有 的 用 例 创 建 了 包 ， 而 把 这 些 包 
整合 到 Meteor 项 目 中 也 很 简单 。 
有 两 种 方法 可 以 在 一 个 项 目 中 添加 npm 包 。 第 一 种 方法 是 把 它 封装 进 一 个 Meteor 包 ， 这 通常 
是 比较 好 的 方法 。 大 多 数 npm 包 的 设计 只 在 服务 器 环境 中 工作 , 所 以 它们 不 遵循 Isopack 的 同 构 性 。 
第 二 种 方法 是 使 用 meteorhacks:npm 包 ， 它 可 以 让 你 像 通 常 的 Nodejs 项 目 那 样 使 用 


packages.json。 
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为 apm 模块 写 一 个 同 构 的 封装 器 是 相当 高 级 的 主题 ， 这 超出 了 本 书 的 范围 ， 所 以 我 们 将 专注 
于 直接 引入 模块 。 让 我 们 从 添加 所 需 的 Meteor 包 开始 : 


$ meteor add meteorhacks :npm 


这 个 包 增 强 了 Meteor 应 用 ， 使 npm 模 块 可 以 直接 使 用 。 在 添加 模块 之 前 ， 这 个 包 需 要 进行 一 
些 配置 ， 因 此 在 项 目 中 添加 meteorhacks :npm 包 以 后 ， 必须 使 用 meteor run 命 令 来 运行 项 目 。 
作为 运行 的 结果 ， 一 个 新 的 文件 夹 packages 将 被 添加 到 项 目 中 。 它 包含 一 个 npm-container 包 ， 
这 个 包 将 负责 添加 npm 模 块 。 

要 指定 需要 添加 到 项 目 中 的 模块 ,需要 使 用 packages.json 文 件 .npm 包 添加 以 后 ,packages.json 
文件 在 第 一 次 运行 Meteor 项 目 时 会 被 创建 ， 它 位 于 应 用 文件 夹 的 根 目 录 。 如 代码 清单 9-1 所 示 ， 
所 有 需要 添加 到 应 用 中 的 模块 被 列 为 键 , 而 所 需 的 版 本 为 值 。 我 们 使 用 gravatar 模 块 作为 例子 。 
代码 清单 9-1 通过 packages.json 添 加 npm 包 

{ 


We ee byds er ous i ER 























} 


调整 packages.json 文 件 的 内 容 并 重新 启动 Meteor，npm 模 块 将 会 自动 添加 。 因 为 npm 不 提供 客 
户 端 功能 ， 所 以 模块 在 服务 器 端 代码 中 使 用 Meteor .npmRequire () 来 加 载 。 一 旦 模块 被 加 载 ， 
就 可 以 像 在 普通 Node.js 应 用 中 那样 使 用 它 。 可 以 参考 模块 的 文档 学 习 更 多 相关 的 内 容 。 对 于 
gravatar 模 块 , 你 可 以 通过 调用 gravatar.url (emai1) 来 获取 用 户头 像 的 URL, 这 里 的 smail 
需要 是 一 个 Gravatar 账 户 的 有 效 电子 邮件 地 址 ( 见 下 面 的 代码 清单 )。 


代码 清单 9-2 ”从 Meteor 的 方法 中 使 用 Gravatar npm 模 块 
Meteor.methods({ 
getGravatar: function(email)t 
Var gravatar = Meteor.npmRequire('gravatar'); 























Var url = gravatar.url (email); 
return url; 
} 
3 


这 种 方法 可 以 从 代码 的 任何 地 方 调用 ， 它 使 用 下 面 这 个 熟悉 的 语法 : 


Meteor.call('getGravatar', 'mail@example.org', function(err, res) { 
return res; 


}); 


9.4 创建 lsopack 


所 有 可 在 不 同 应 用 中 使 用 的 功能 都 应 该 实现 为 一 个 包 ， 以 实现 最 大 的 可 移植 性 。 此 外 ， 对 构 
建 单个 应 用 而 言 ， 把 不 同 的 功能 视 为 组 件 是 一 个 好 的 做 法 。 这 有 助 于 将 各 个 关注 点 清楚 地 分 开 ， 
是 维护 可 扩展 性 的 一 个 基石 。 通 常 大 的 代码 库 都 会 被 拆 分 为 许多 包 ， 它 们 也 大 大 受益 于 此 。 
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创建 包 涉及 多 个 步骤 。Meteor 还 不 支持 私有 的 包 存 储 库 ， 所 以 所 有 的 包 必须 是 公开 的 , 或 者 
在 一 个 项 目的 包 文件 夹 中 供 本 地 使 用 , 这 也 通常 是 包 开 发 开始 的 地 方 。 每 个 包 在 发 布 到 官方 包 存 
储 库 之 前 ， 必 须 经 过 测试 。tinytest 包 是 专门 为 包 的 单元 测试 而 设计 的 。 

为 演示 Isopack 的 创建 过 程 ， 我 们 将 向 你 展示 如 何 把 第 5 童 介绍 的 通知 功能 封装 成 一 个 包 ， 这 
样 你 就 可 以 使 用 一 行 代码 轻松 地 创建 错误 、 警 告 或 成 功 的 消息 。 


9.4.1 创建 包 


每 个 包 都 有 一 个 由 前 级 标识 的 维护 者 。Meteor 开 发 者 可 以 使 用 他 们 自己 的 用 户 名 或 组 织 
( 允许 多 个 人 工作 在 同一 个 包 上 )。 如 果 你 是 一 个 注册 的 Meteor 开 发 者 ,应 该 使 用 你 的 用 户 名 作为 
前 级 创建 新 包 。 如 果 你 还 没有 注册 账号 ， 可 以 在 meteor.com 网 站 上 注册 。 

决定 把 一 个 新 包 放 在 哪里 时 你 有 两 个 选择 : 在 现 有 应 用 之 中 或 之 外 。 如 果 选 择 在 一 个 现 有 应 
用 中 创建 新 的 包 ， 你 必须 使 用 meteor add 命 令 。 最 干净 的 解决 方案 是 在 任何 应 用 的 上 下 文 之 外 
创建 新 的 包 。 因 此 ， 你 应 该 在 当前 应 用 之 外 创建 新 的 包 。 

创建 一 个 新 包 的 语法 如 下 : 


$ meteor create --package <prefix>:<name> 


你 将 创建 一 个 新 的 notifications 包 ， 前 级 为 neteorinaction， 如 图 9-6 所 示 。 该 命令 创 
建 包 的 文件 结构 模板 ， 包 括 一 个 readme.md 文 件 。 


自述 文件 ， 用 于 Atmospherejs.com 




















































































































包 的 单元 测试 














MacBook:meteorinaction stephan$ meteon create 一 package meteorinaction:notifications 
meteorinaction:notifications: created jin notifications 
MacBook:meteorinaction stephan$ tree hotifications 
notifications 
README .md 
发 内 窑 notifications-tests.js 
包 的 内 EE notifications.js 
package, js 
9 directories，4\fites 
MacBook:meteorinaction stephan$ 
包 的 实际 功能 创建 一 个 新 的 包 
包 的 元 数据 





图 9-6 使 用 meteor create --package 创 建 notification 包 


这 个 基本 结构 假定 所 有 的 代码 都 放 在 一 个 单独 的 JavaScript 文 件 中 ,所 有 的 单元 测试 都 在 一 个 
专门 的 *-tests.js 文 件 中 ， 元 数据 ， 如 包 的 名 称 、 版 本 和 依赖 关系 ， 放 在 package.js 文 件 中 。 和 常规 
的 Meteor 项 目 一 样 ,你 不 需要 保持 给 定 的 结构 ,唯一 的 强制 性 文件 是 package.js， 所 以 让 我 们 从 这 
里 开始 。 
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9.4.2 ”声明 包 的 元 数据 
文件 package.js 包 含 三 个 重要 的 块 。 








D Package.describe() 包 的 名 称 和 描述 ， 以 及 一 个 git 仓 库 的 链接 。 
口 Package.onUse () 包 的 实际 定义 , 使 用 的 Meteor API 版 本 , 使 用 了 哪些 文件 ， 等 等 。 
D Package.onTest () 包 的 测试 定义 。 





使 用 这 些 块 可 以 对 某 些 任务 进行 细 粒 度 的 控制 ， 比 如 声明 文件 的 加 载 顺序 。 这 个 文件 中 的 所 
有 设置 都 可 以 对 项 目 中 是 否 能 使 用 某 个 包 有 影响 。 主 要 成 分 是 带 语义 的 版 本 号 ， 就 像 上 一 节 中 解 
释 的 那样 。 

如 果 一 个 包 依赖 于 npm 包 ， 可 使 用 第 四 个 块 : Npm.depends () 。 对 于 使 用 npm 的 包 ， 你 不 需 
要 添加 meteorhacks:npm 包 。 

















1. Package .describe 

descripe 块 决定 一 个 包 的 实际 名 称 。 无 论 路 径 名 称 是 什么 ， 设 置 的 name 值 会 优先 使 用 。 下 
面 的 这 些 属 性 在 描述 中 设置 。 
一 个 独特 的 包 名 ， 使 用 Meteor 的 开发 者 账户 /组 织 作 为 前 级 。 
口 version 一 一 使 用 major .minor .patch 格 式 的 版 本 号 。 使 用 连 字符 , 你 可 以 在 补丁 号 后 
添加 预 发 布 信息 ， 如 1 .1.0-rc1。 
D summary 使 用 meteor search 命 令 时 显示 出 来 的 一 行文 字 。 
口 git 一 一 包含 该 包 源 代码 的 Git 仓 库 URL。 
你 要 使 用 的 文档 文件 ， 如 果 没 有 文档 可 使 用 ， 它 必须 设置 为 nul1l。 
D daebugonly 一 一 如 果 设 置 为 true，puildq 命 令 打包 的 时 候 就 不 会 包含 这 个 包 。 

2. Package .onUse 

这 个 块 是 包 的 核心 ， 没 有 它 ， 包 不 会 完成 任何 事情 。Package.onUse () 以 一 个 函数 作为 参 
数 。 它 拥有 包 控 制 api 的 对 象 ， 可 对 依赖 性 和 输出 对 象 进行 跟踪 。 

通过 api .versionsFrom() 进 行 的 第 一 个 设置 应 该 是 这 个 包 所 依赖 的 Meteor API 的 版 本 。 这 
个 版 本 设置 了 该 平台 上 所 有 版 本 依赖 的 基础 。 如 果 一 个 包 需 要 其 他 包 , 这 些 包 将 被 列 在 api .use () 
的 声明 中 。 通 常 所 有 的 包 必 须 包 含 一 个 版 本 声明 ， 比 如 templatinge1.0.11。 因 为 模板 包 是 
Meteor 核 心 的 一 部 分 , 并 且 我 们 已 经 使 用 api .versionsFrom() 设 定 了 一 个 基准 , 所 以 我 们 可 以 
省 略 这 个 版 本 字符 串 。 所 有 的 社区 包 必 须 包 括 版 本 约束 。 其 形式 可 以 为 packagee=1.0.0( 要 求 
准确 版 本 1.0.0 ) 或 package@1.0.0 (要求 版 本 至 少 为 1.0.0 )。 甚 至 有 可 能 使 用 这 样 的 组 合 : 

api.use('package@1.0.0 || =2.0.1'); 

在 这 个 例子 中 , 求解 器 将 尝试 使 用 确切 的 2.0.1 版 本 。 如 果 这 是 不 可 能 的 , 它 将 会 使 用 这 个 包 
的 任何 1.x.y 版 本 。 

如 果 一 个 包 依赖 于 多 个 其 他 包 , 这 些 包 以 一 个 数组 的 形式 提供 。api .use 的 第 二 个 参数 指定 
了 体系 结构 ， 即 server、client、web.browser 或 web.cordova。 尺 管 包 是 同 构 的 ， 但 这 些 
设置 将 会 生成 更 精简 的 输出 。 如 果 一 个 包 只 在 服务 器 上 使 用 , 它 的 生成 过 程 将 不 会 包括 浏览 器 端 











口 name 

















口 document 
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的 捆 乡 ， 从 而 减少 了 需要 通过 网 络 发 送 数 据 的 大 小 。 

要 从 业务 逻辑 中 访问 包 的 功能 ， 可 通过 api .export () 导 出 全 局 对 象 , 它们 在 所 有 的 代码 中 
可 用 。 再 次 ,有 可 能 指定 这 个 全 局 对 象 在 什么 上 下 文中 可 用 。 对 于 显示 通知 而 言 ， 你 将 导出 一 个 
仅 在 客户 端 使 用 的 Notification 全 局 对 象 。 
使 用 多 个 源 文件 时 ，api.aadqFiles () 接 受 一 个 列 出 所 有 文件 名 的 数组 ; 否则 ,一 个 字符 串 
就 足够 了 。 和 Meteor 的 应 用 相反 , 只 有 那些 在 这 里 列 出 的 文件 会 被 自动 加 载 , 而 不 是 所 有 的 文件 。 
它们 传递 给 aaaFiles 的 顺序 也 指定 了 它们 的 加 载 顺 序 。 

meteorinaction:notifications 包 使 用 三 个 文件 :一 个 JavaScript 一 个 HIML 和 一 个 CSS 
文件 。 完 整 的 onUse () 定义 如 下 所 示 。 


代码 清单 9-3 ”定义 通知 (notifications ) 包 
Package.onUse (function (api) { 
api.versionsFrom('1.1.0.2'); 









































api.use([ 
'templating', 
Ti" 
3 
“Glient. 
小 
api.export ( 
NOtificGation",y 
'client' 


总 
api.addFiles([ 
'notifications.html', 
'notifications.js', 
'notifications.css' 
ss 
'client' 
); 
jo 


3. Package.onTest 

默认 情况 下 , 所 有 的 包 都 使 用 tinytest 包 进行 测试 , 因此 它 是 onTest () 块 内 第 一 个 要 声明 
的 依赖 关系 。 需 要 测试 的 包 也 必须 被 声明 为 一 个 依赖 ,即使 它 是 当前 包 。 正 如 你 在 下 面 的 代码 清 
单 中 所 看 到 的 ， 整 体 的 语法 类 似 于 Package .onUse () 。 


代码 清单 9-4 ”为 notifications 包 定义 单元 测试 
Package.onTest (function(api) { 

api.use('tinytest'); 

api.use('meteorinaction:notifications'); 

api.addFiles('notifications-tests.js', 'client'); 








) ) ; 
现在 ， 我 们 有 了 所 有 的 元 数据 定义 ， 也 就 可 以 实现 包 功 能 
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npm 包 的 依赖 

如 果 一 个 包 需 要 npm 包 的 功能 ， 其 依赖 声明 如 下 : 

Npm.depends ({package: 'version'}) 

此 代码 将 使 npm 包 在 应 用 中 可 用 。 要 使 用 它 的 功能 , 不 用 使 用 普通 Node.js 语 法 的 require,， 
简单 地 给 它 添加 一 个 Nom 前 级 就 可 以 了 : 


Package = Npm.require('package'); 


9.4.3 ”添加 包 的 功能 


notifications 包 由 三 个 文件 组 成 。 
口 样式 (style) 
口 模板 (template ) 
口 JavaScript 代 人 码 

在 样式 文件 中 ， 你 定义 了 三 个 类 : error 、success 和 warning。 每 个 类 都 有 不 同 的 
background-color 和 color 属 性 ， 用 于 区 分 错误 的 类 型 。 你 可 以 复制 第 5 章 的 模板 代码 到 
notifications.html 文 件 , 如 代码 清单 9-5 所 示 。 你 将 对 它 进行 一 点 改进 , 以 使 用 一 个 按钮 来 解除 通知 。 


代码 清单 9-5 ” notifications 包 的 模板 代码 
<template name="notificationArea"> 
{{#with notification}} 
<p class="{{type}}">{{text}}</p> 
<button>{{buttonText}}</button> 
{{/with}} 
</template> 


所 有 通知 都 将 存储 在 一 个 session 变 量 中 。 因 此 ， 我们 需要 一 个 模板 辅助 函数 来 显示 
session.get('notify') 的 内 容 。 另 外 ， 你 可 以 重用 第 5$ 章 的 代码 。 当 用 户 单 击 按钮 时 ， 你 还 
需要 一 个 事件 函数 来 清除 变量 内 容 ( 见 下 面 的 代码 清单 )。 


代码 清单 9-6 用 于 notifications 包 的 模板 辅助 函数 和 事件 
Template.notificationArea.helpers({ 
notification: function () { 
return Session.get('notify'); 
} 
所 及 

































































Template.notificationArea.events(t{ 
'click putton': function () { 
Session.set('notify', ''); 

} 
字 


在 使 用 该 包 之 前 ， 必 须 通 过 package.js 文 件 中 定义 的 全 局 Notification 对 象 来 暴露 包 的 功 
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能 。 你 将 添加 四 个 函数 来 设置 和 清除 消息 。 


口 setSuccess 


口 setWarnind 





口 setError 





口 clear 


这 里 的 每 个 函数 都 将 Session 对 象 的 内 容 设置 为 不 同 的 值 ( 见 下 面 的 代码 清单 )。 
代码 清单 9-7 通过 全 局 的 Notifications 对 象 暴露 包 的 功能 


Notification = { 
setError: function (text) { 
Session.set('notify', { 
type: 'error', 
text: text, 
buttonText: 'Oh, no.' 
}); 
} 
setWarning: function (text) { 
Session.set('notify', { 
type: 'warning', 
text: text, 
buttonText: 'Good to know...' 
}); 
} 


setSuccess: function (text) { 





Session.set('notify', { 
type: 'success', 
text: text, 


buttonText: 'Cool!' 
}); 
} 
clear: function () { 
Session.set('notify', ''); 
} 
上 


这 就 是 需要 做 的 ， 现 在 你 有 了 一 个 功能 齐全 的 包 。 但 在 一 个 项 目 中 使 用 它 之 前 ,你 需要 添加 于 
它 ， 就 像 添加 其 他 包 一 样 : 

$ meteor add meteorinaction:notifications 

Meteor 希 望 在 项 ed 但 是 ， 如 果 你 在 应 用 之 外 创建 了 一 个 包 
呢 ? 你 总 是 可 以 在 文件 系统 中 创建 一 个 链接 , 但 这 不 能 在 各 种 工作 站 上 都 很 好 地 工作 。 最 好 是 通 
过 环境 变量 PACKAGE es 

在 这 个 例子 中 ， 包 放 在 /Users/Stephan/code/packages/notifications 目 录 ， 这 就 是 我 们 的 应 用 需 
要 的 包 目 录 。 因 此 ， 我 们 要 将 PACKAGE_DIRS 设 置 为 /Users/Stephan/code/packages/。 它 会 自动 找 
到 notifications 包 。 设 置 这 个 全 局 的 环境 变量 的 方法 是 ， 使 用 $ export PACKAGE_DIRS=/ 
Users/Stephan/code/packages ( Linux 和 Mac ) 或 C:\>set PACKAGE_ DIRS=c:\code\ 
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packages ( Windows ), 或 调用 meteor 命 令 直接 设置 ( 如 果 你 在 Windows 上 , 一 定 要 调整 路 径 ); 


$ PACKAGE_DIRS=/Users/stephan/code/packages meteor add meteorinaction:notifications 








说 明 记 住 ， 如 果 在 调用 meteor 时 设置 了 环境 变量 ， 你 也 必须 在 每 次 调用 meteor run 命 令 时 
设置 它 ， 这 样 才能 找到 包 的 位 置 。 


如 果 你 在 添加 包 时 遇 到 问题 ,请 检查 它 是 否 确实 存在 并 在 packagejs 文 件 中 声明 了 正确 的 名 字 。 

在 开始 包 的 单元 测试 之 前 , 让 我 们 快速 地 进行 一 个 手动 测试 。 在 你 的 应 用 中 添加 notifica- 
tionArea 模 板 ， 并 通过 全 局 的 Notifications 设 置 一 个 消息 。 为 了 保持 事情 的 简单 性 ,你 可 以 
使 用 默认 的 Meteor 应 用 并 扩展 按钮 点 击 ， 如 代码 清单 9-8 所 示 。 图 9-7 显 示 了 结 


代码 清单 9-8 通过 notifications 包 添加 一 个 通知 
Template.gravatar.events({ 
"Lick button": function (evt; .tpl) { 

YA ae 

Meteor.call('getGravatar', email, function (err, res) { 
人 
Session.set('gravatarUrl', res); 
Notification.setSuccess('I found a gravatar image!'); 





Tl 











单 击 此 按钮 将 删除 通知 {{> notificationArea}} 


Chapter 9 - The package system 


[I found a gravatar image! 
~ 
Cooll 











Look up gravatar URL 


Show the gravatar image for an email address 





mail@manuel-schoebel.com | | Look up image 


单 击 这 个 按钮 触发 


Notification.setSuccess () 





图 9-7 使 用 notifications 包 


现在 , 你 知道 这 个 包 可 以 工作 , 接 下 来 将 实现 单元 测试 ， 以 确保 你 在 未 来 升级 包 时 其 核心 功 
能 不 会 被 破坏 。 
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全 A 


9.4.4 使 用 tinytest 测试 lsopack 
tinytest 包 的 设计 是 为 了 使 包 的 测试 尽 可 能 简 
到 行 和 分 析 测 试 更 简单 。 再 次 ， 


现 所 有 的 测试 结果 ,使 其 一 目 了 然 , 也 使 运行 和 


CLI 工 具 ; 
$ meteor test-packages 
此 代码 将 在 localhost:3000 启 动 一 个 Meteor 应 用 ， 在 这 里 你 可 以 看 到 所 有 的 测试 


单 。 它 配备 了 一 个 很 好 的 Web 界 面 ， 用 于 呈 
运行 包 测 试 可 使 用 meteor 



































上 二 上 
结果 





通过 的 测试 数量 和 


( 图 9-8 )。 
所 有 测试 总 的 测试 
执行 时 间 所 有 的 测试 数量 
手动 重新 运行 
所 有 的 测试 








个 别 测试 的 结 
果 和 持续 时 间 
图 9-8 tinytest 的 测试 报告 





























个 普通 的 Meteor 应 用 那样 。 如 果 想 在 




















如 果 你 改变 了 任何 测试 ,测试 将 自动 重新 运行 ， 就 像 
开发 应 用 的 同时 也 运行 tinytest 测 试 报告 ， 可 以 为 测试 报告 指定 一 个 不 同 的 端口 : 
$ meteor test-packages --port 4000 
EE， 你 可 以 在 http://localhost:4000 运 行 测 斌 报告， 在 http://localhost:3000 运 行 正常 的 Meteor 
中 。 
































的 tinytest 单 元 测试 显示 在 下 面 的 代码 清 生 














这 相 
应 用 。notifications 包 的 一 个 简 生 
代码 清单 9-9 用 tinytest 测 试 Notification.setError 
function (test) { | 首先 ， 在 tinytest 中 加 
| 一 个 有 名 字 的 测试 


Tinytest.add('setError', 
Var msgText = 'An error message'; 
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Notification.setError (msgText); 

test.equal (Session.get ('notify') .text, msgText); tinytest 暴 露 了 一 些 测试 

test.equal (Session.get ('notify') .type, 'error'); 函数 ， 比 如 equal 
和 
如 果 想 让 你 的 测试 更 加 结构 化 ， 可 以 在 测试 名 称 中 使 用 连 字 符 。 这 样 ， 你 可 以 把 测试 分 组 ， 
在 测试 报告 中 看 到 更 好 的 结构 。 你 使 用 sg 把 所 有 消息 相关 的 测试 分 组 ， 然 后 再 通过 消息 类 型 
( success/warning/error ) 进行 分 组 ， 如 下 所 示 : 














Tinytest.add('Msg - Error - setError', function(test) { 
Pe 
ss 


这 可 以 让 你 折 炙 和 展开 各 组 测试 ， 这 对 于 较 大 的 包 尤 为 重要 ( 如 图 9-9 所 示 )。 


Msg 组 中 的 
Msg 组 的 测试 alear 测 试 失败 








e tinytest - Msg - clear 


tinytest 
Msg 
FAIL 5ms  C:clear 
-Ok 
-fail — assert_equal - expected "" - not 
Error 
PASS 1ms  C:setError 
Success 
PASS 2ms  C:setSuccess 
Warning 
| PASS 6 ms  C:setWaming 


每 个 消息 类 型 


组 下 的 子 组 














图 9-9 ”使 用 分 组 来 结构 化 tinytest 报 告 的 输出 
让 我 们 再 来 看 看 package.js 中 定义 的 测试 设置 


Package.onTest (function(api) { 

api.use('tinytest'); 
api.use('meteorinaction:notifications'); 
api.addFiles('notifications-tests.js', 'client'); 











}9:; 
最 后 一 行 声明 这 个 测试 仅 在 客户 端 上 运行 .如 果 你 把 这 行 改 为 api .addFiles ('notifica- 
tions-tests.js');， 测 试 将 在 应 用 构建 目标 的 每 个 环境 中 运行 。 对 默认 的 应 用 而 言 ， 这 包括 














9.4 创建 Isopack 


193 





client 和 server。 














如 果 通 知 测试 在 服务 器 端 运 行 ， 它 们 将 全 部 失败 ， 因 为 全 局 的 Notification 只 暴露 给 客户 
端 。 该 Web 报 告 将 显示 所 有 的 测试 ,无 论 它们 在 哪个 平台 上 运行 。 每 个 测试 以 一 个 s 或 c 来 显示 它 






































是 在 服务 器 还 是 在 客户 端 上 运行 ( 参见 图 9-10 )。 





























, C 代 A Notification 在 服务 器 上 不 
i 代表 客户 端 可 用 ， 这 会 导致 测试 失败 
®0® /Gr ~ a | 加 


€ 3 G|D localhost:3000 

















S: clear 
- exception - message Notification is not defined 


ReferenceError: Notification is not defined 
at Package (packages/local-test: rinaction:notifications/notifications-tests.js:24:1) 
at [object Object].func (packages/tinytest/tinytest.js:636:1) 

at packages/tinytest/tinytest.js:406:1 

at [object 0bject] ._-.extend . 

at packages/meteor/timers. 







| 


PASS 
Error 
FAIL 
~ exception - message Notification is not defined 
ReferenceError: Notification is not defined 
at Tinytest.add.msgText (packages/local-test:meteorinaction:notifications/notifications-tests.js:3:1) 
at [object Object].func (packages/tinytest/tinytest.js:636:1) 
at packages/tinytest/tinytest .js:406:1 
at [object Object].-.extend.withValue (packages/meteor/dynamics_nodejs.js:56:1) 
at packages/meteor/timers.js:6:1 
at runWithEnvironment Cpackages/meteor/dynamics_nodejs.js:108:1) 


PASS 21ms  C:setError 
Success 
FAIL S: setSuccess 


~ exception - message Notification ls not defined 





ReferenceError: Notification is not defined 
at Tinytest.add.msgText (packages/local-test:meteorinaction:notifications/notifications-tests.js:10:1) 
at [object Object].func (packages/tinytest/tinytest.js:636:1) 
at packages/tinytest/tinytest .js:406:1 
at [object Object].-.extend.withValue (packages/meteor/dynamics_nodejs.js:56:1) 
at packages/meteor/timers.js:6:1 
at runWithEnvironment (packages/meteor/dynamics_nodejs.js:108:1) 


PASS 50ms  C:setSuccess 
C Rerun 


图 9-10 在 客户 端 和 服务 器 上 运行 相同 的 测试 





你 还 可 以 指定 要 在 服务 器 上 和 客户 端 上 运行 的 单个 测试 。 你 应 该 使 用 cinytest 对 包 进行 单 

















元 测试 ， 尤 其 是 当 你 想 发 布 包 并 让 其 他 人 也 可 以 使 用 它们 的 时 候 。 
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tinytest API 的 简明 参考 
不 幸 的 是 ，tinytest 包 没有 很 好 的 文档 ， 但 大 多 数 API 调 用 是 很 简单 的 ， 因 为 它们 遵循 
基本 的 测试 操作 。 下 面 是 编写 单元 测试 时 可 以 使 用 的 操作 列表 。 


| ‘ese Sunil (dl etre mssate, nec) 











test.notEqual (actual, expected, message) 


test.instanceOf (obj, class) 





test.matches(actual, regexp, message) 
test.isTrue(actual, msg) 
test.isFalse(actual, msg) 

test.isNull (actual, msg) 

east Norunacer se 


test.isUndefined(actual, msg) 





test.isNaN(actual, msg) 





DOOOOOOODODO DO 


test.length(obj, expected length, msg) 


9.4.5 发布 


每 个 新 的 包 都 始 于 本 地 包 。 虽 然 这 是 不 错 的 ， 但 也 有 缺点 。 首 先 ， 为 了 在 应 用 之 间 共 享 包 ， 
你 必须 手动 复制 并 粘贴 它 的 文件 夹 。 无 法 通过 meteor update 命 令 进 行 自动 更 新 ， 因 为 版 本 求 
解 需 无 法 访问 本 地 的 存储 库 。 另 一 方面 ,使 用 本 地 包 是 保持 代码 私有 的 唯一 选择 。 一 旦 一 个 包 被 
发 布 , 任何 人 都 可 以 在 他 们 的 Meteor 项 目 中 使 用 它 ， 所 以 了 解 什么 时 候 不 使 用 publish 命 令 也 是 
重要 的 。 

在 Meteor 支 持 私 有 包 存 储 库 之 前 ,发 布 包 并 利用 版 本 求解 器 的 唯一 方法 是 使 它 公 开 。 要 做 到 
这 一 点 ， 你 需要 有 一 个 Meteor 开 发 账户 。 

发 布 到 Meteor 库 的 每 个 Meteor 包 都 和 一 个 用 户 或 组 织 相 关联 。 用 户 名 或 组 织 名 始终 是 包 的 一 
部 分 ， 它 提供 和 命名 空间 一 样 的 功能 。 你 可 以 用 它 来 建立 你 作为 一 个 高 质量 包 开 发 者 的 声誉 。 

1. 首次 发 布 

一 旦 包 在 可 用 的 状态 并 且 通 过 了 所 有 的 测试 ， 它 就 可 以 发 布 到 Meteor 的 包 基 础 设施 中 。 使 用 
publish 命 令 可 做 到 这 一 点 。 发 布 新 的 包 还 必须 包括 一 个 --create 参 数 : 


$ meteor publish --create 


包 的 所 有 后 续 更 新 可 以 使 用 meteor publish 命 令 。 在 你 发 布 包 后 ， 可 以 使 用 meteor ada 
authorname :packagename CLI 命 令 把 它 添加 到 任何 Meteor 应 用 中 。 
















































































发 布 错误 
当 你 发 布 包 时 ,可 能 出 错 的 事情 不 会 有 很 多 。 最 常见 的 一 个 错误 是 试图 发 布 一 个 已 有 包 的 





相同 版 本 或 是 旧 的 版 本 。 
一 些 用 户 已 经 报告 ， 发 布 位 于 实际 Meteor 项 目下 packages 目 录 中 的 包 时 会 有 问题 。 如 果 你 
遇 到 发 布 包 的 问题 ， 请 尝试 将 它们 从 现 有 的 项 目 中 移出 。 


一 个 包 发 布 以 后 ， 它 对 meteor search 命 令 是 可 见 的 ， 也 将 在 atmospherejs.com 上 出 现 。 记 
得 包含 一 个 有 用 的 自述 文件 , 说明 如 何 使 用 这 个 包 。 要 使 atmospherejs.com 显 示 自 述 文件 的 内 容 ， 
你 还 需要 在 package.js 文 件 中 配置 一 个 有 效 的 Git 仓 库 。 

2. 更 新 

更 新 一 个 包 基 本 上 需要 两 个 步骤 。 首 先 ， 在 你 的 package.js 文 件 中 增加 版 本 号 。 然 后 ， 在 包 
文件 夹 中 使 用 meteor publish 命 令 发 布 更 新 。 与 最 初 的 publish 命 令 相 比 ， 此 时 没 必 要 使 用 
--create 参 数 。 

3. 取消 发 布 

没有 办 法 删除 一 个 已 发 布 的 包 。 其 中 的 原因 是 , 你 不 知道 是 否 有 人 已 经 在 使 用 你 的 包 ， 删除 
包 将 破坏 每 个 使 用 该 包 的 应 用 。 

取消 发 布 或 删除 包 相近 似 的 唯一 一 件 事 是 对 search 和 show 命 令 隐 藏 一 个 包 。 为 此 ， 你 可 以 
设置 一 个 包 为 unmigrated。 在 一 个 包 的 根 文件 夹 中 发 出 以 下 命令 ， 将 其 从 公共 存储 库 的 所 有 搜 
索 结果 中 排除 : 


$ meteor admin set-unmigrated 












































9.5 总 结 


在 本 章 中 ， 你 已 经 了 解 到 以 下 内 容 。 

口 Meteor 应 用 利用 了 一 个 强大 的 包 系 统 ， 其 中 包含 了 Isopack 、npm 包 和 Cordova 搬 件 。 

口 公共 包 存 储 库 是 由 Meteor 托 管 的 ， 可 以 通过 meteor search 或 在 http:/atmospherejs.com 
访问 ， 你 可 以 在 那里 浏览 

口 所 有 的 包 都 有 一 个 语义 版 本 号 ， 这 人 允许 版 求解 器 来 确定 一 个 项 目 所 有 包 的 版 本 优化 组 合 。 
口 创建 包 有 助 于 让 应 用 有 更 好 的 结构 。 

口 tinytest 是 专 为 测试 Isopack 功 能 的 单元 测试 库 。 
口 任何 一 个 具有 Meteor 开 发 账户 的 人 都 可 以 将 包 发 布 到 公共 库 中 。 

口 一 个 包 一 旦 发 布 ， 就 不 能 删除 ， 但 它 可 以 被 设置 为 不 可 见 的 状态 。 
































本 章 内 容 

口 了 解 同 步 汕 数 和 异步 函数 之 间 的 区 别 
口 使 用 异步 函数 

口 整合 外 部 API 

口 上 传 文件 























虽然 Meteor 是 一 个 同 构 的 平台 , 但 有 些 事情 只 能 在 某 些 环境 中 完成 。 本 章 向 你 介绍 服务 器 上 
的 一 些 高 级 概念 。Nodejs 在 后 台 运 行 , 现在 是 时 候 来 仔细 看 看 事件 循环 和 使 用 异步 代码 的 正确 方 
式 了 。 如 果 打 算 让 你 的 应 用 与 外 部 API 进 行 通信 ， 这 将 特别 有 用 。 

在 讨论 服务 器 端的 细节 时 ,我 们 还 将 讨论 一 个 上 传 文件 到 服务 器 的 简单 方法 。 除 非 另 有 说 明 ， 
否则 本 章 中 的 代码 应 该 在 服务 器 上 运行 。 


10.1 再 次 介绍 Node.js 


Meteor 栈 的 基础 是 Node.js (参见 图 10-1 )。 从 技术 上 讲 ， 它 是 V8 JavaScript 引 | 敬 的 服务 器 端 实 
现 ， 你 也 可 以 在 谷歌 的 Chrome 浏 览 絮 中 找到 这 个 引擎 。 因 此 ，Node.js 显 示 出 和 浏览 器 一 样 的 特 
点 并 不 会 令 人 惊讶 。 这 是 因为 有 以 下 两 个 原因 : 
口 Node.js 是 事件 驱动 的 ; 
口 Nodejs 使 用 非 阻塞 IO 。 















































Nodejs 措 载 V8 引 擎 ， 与 和 王族 个 
谷歌 Chrome 浏 览 器 有 相 | | | 
同 的 JavaScript 引 擎 ~ | : 





图 10-1 Node.js 是 所 有 Meteor 应 用 的 服务 器 引擎 
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这 两 个 特点 使 得 Node.js 从 其 他 服务 器 技术 ( 如 PHP 或 Rails ) 中 脱颖而出 ， 这 些 技术 通常 以 线 
性 或 同步 方式 执行 代码 。 但 即使 Nodejs 本 质 上 是 非 阻塞 的 ， 你 仍然 可 以 写 出 阻塞 的 代码 

JavaScript 是 为 特定 环境 而 设计 的 ,其 中 的 动作 可 能 需要 很 长 的 时 间 ， 比 如 通过 56K 调 制 解 调 
器 连接 服务 需 查 询 额外 的 数据 。 它 不 会 因为 等 待 一 个 返回 值 而 阻止 所 有 其 他 动作 的 执行 。 想 象 一 
下 打 电 话 到 呼叫 中 心 然后 等 待 。 你 是 听 着 音乐 等 待 ， 还 是 边 等 待 边 做 一 些 其 他 的 事情 ， 比 如 整理 
你 的 办 公 桌 、 四 处 走 走 或 浏览 一 下 网 页 ?如 果 你 在 等 待 的 时 候 做 任何 其 他 的 事情 , 那么 你 的 呼叫 
就 不 会 阻止 其 他 活动 ， 这 可 以 认为 是 异步 的 。 

回调 函数 通常 用 于 JavaScript 中 , 一 旦 结果 可 用 就 回 到 这 个 任务 。 如 果 呼 叫 中 心 是 由 JavaScript 
支持 的 , 那么 他 们 就 不 会 让 你 等 待 ， 而 是 会 给 你 一 个 回调 函数 , 一旦 代理 人 有 时 间 和 你 说 话 就 可 
以 调用 。 然而 他 们 常常 并 没有 这 样 做 ， 可 能 是 因为 跟踪 大 量 的 回调 函数 很 困难 。 


10.1.1 同步 代码 


虽然 Meteor 基 于 Node.js 的 单线 程 事件 循环 架构 ( 还 记得 第 1 章 中 比萨 的 例子 吗 ), 但 其 方法 的 
一 般 编 程 风格 是 同步 的 而 不 是 典型 的 Node.js 异 步 回 调 风 格 。 线性 运行 模型 更 容易 学 习 和 理解 , 尤 
其 是 在 服务 器 上 。 这 意味 着 函数 依次 执行 , 然后 返回 最 终 的 值 Meteor 保 留 了 Node.js 的 可 扩展 性 ， 
并 将 其 与 一 种 简化 的 编码 方式 相 结 合 ( 见 下 面 的 代码 清单 )。 


代码 清单 10-1 方法 中 阻塞 的 同步 代码 
addSync = function(a, b){ < 一 
return a + b; 将 两 个 值 相 加 
) 的 同步 函数 


0 

















出 


























































































































blockFor3s = function(value) { 
Var waitUntil = new Date().getTime() + 3000; 
while(new Date() .getTime() < waitUntil) {}; 
return value; 
} 
阻塞 CPU 3 秒 
Meteor .methoqs ({ 
'blockingMethod': function(value){ 
console.log('Method.blockingMethod called'); 
Var returnValue = 0; 
resultComputation = blockFor3s (value); < 一 
returnValue = addSync (resultComputation, 1); < 
return returnValue; < 一 这 两 个 
人 成 后 返 
代码 清单 10-1 使 用 一 个 简单 的 方法 来 处 理 两 个 同步 函数 并 返回 结果 。blockFor3s 函 数 的 调 
用 方式 完全 占用 了 服务 器 的 CPU， 直 到 它 完成 , 这 有 效 地 阻止 了 CPU 处 理 所 有 其 他 的 请 求 。 它 们 
必须 等 待 , 直到 阻塞 函数 完成 。 你 很 容易 就 能 测试 这 一 点 一 一 打开 两 个 浏览 器 ， 并 在 两 个 浏览 器 
的 控制 台中 使 用 下 面 的 方式 调用 该 方法 : 


Meteor.call('blockingMethod', 1); 


同步 相 加 
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你 会 注意 到 , 第 一 个 浏览 器 会 导致 这 个 方法 运行 并 且 console.log 消 息 会 在 终端 输出 。 如 果 在 3 

你 从 第 二 个 浏览 器 中 调用 该 方法 , 它 不 会 立即 被 调用 ,也 没有 控制 台 消 息 打印 到 终端 。 一 

一 个 方法 调用 完成 ， 第 二 个 方法 调用 将 会 执行 ，console.log 消 息 最 终 输 出 到 控制 台 。 如 果 你 

Be 并 依次 传递 值 1 到 4 到 该 方法 ,结果 将 会 和 图 10-2 所 示 相 同 。 该 
方法 在 每 个 请 求 之 间 和 暂停 3 秒 。 




















@@e 天 methods 
















I29159401-17:13:50.281(2)7 Method.blockingMethod called 
I28158481{17:13:53.281(2)? Method.blockingMethod returns 2 | 
I28158481-17:13:53.282(2)? Method.blockingMethod called 
I28158481{17:13:56.282(2)? Method.blockingMethod returns 3 ] 
128156481-17:13:56.285(2)7 Method.blockingMethod called 
I28158401{17:;13:59,285(2)? th: Eonoethe rotten 4 











服务 器 在 每 
个 响应 之 间 
等 待 3 秒 












I28158481-17:13:59.286(2)? M ngMe: ed 
i :14:82.286(2)? Mh: BSE Mth ET S | 














图 10-2 ”调用 阻塞 的 方法 会 导致 各 响应 之 间 停 顿 3 秒 


现在 想象 有 数 百 个 用 户 向 应 用 发 送 请 求 ,每 个 都 需要 运行 一 个 不 能 并 行 运行 的 方法 。 像 交通 
堵塞 一 样 ， 这 些 请 求 会 堆积 起 来 ， 让 应 用 反应 迟钝 ， 导 致 用 户 体验 差 。 在 事件 循环 中 ， 你 需要 一 
种 可 以 为 其 他 人 让 路 的 方法 ,以 避免 单个 用 户 用 一 个 长 期 运行 的 请 求 阻塞 整个 应 用 。 其 答案 是 使 
用 异步 代码 。 





























10.1.2 ”异步 代码 


为 了 防止 单个 操作 阻塞 所 有 其 他 活动 , 你 应 该 将 长 时 间 运 行 的 任务 转移 到 男 一 个 进程 。 计算 
密集 的 任务 可 以 在 同一 台 机 器 或 远程 服务 器 上 的 另 一 个 处 理 器 上 执行 .Node.js 通 常 使 用 回调 函数 
来 实现 这 一 上 日 标 。 这 意味 着 你 调用 一 个 函数 ,同时 注册 男 一 个 函数 , 一 旦 长 时 间 运 行 的 阻塞 函数 
完成 ， 第 二 个 函数 将 会 运行 一 次 。 这 里 的 第 二 个 函数 就 是 回调 函数 。 这 样 ， 在 等 待 长 时 间 运 行 函 
数 的 结果 的 同时 ，CPU 不 会 被 阻塞， 它 可 以 继续 处 理 其 他 请 求 ( 参见 图 10-3 )。 

在 另 一 个 CPU 上 长 时 间 运 行 的 进程 


















































请 求 1， et 











人 
初始 函数 继续 初始 函数 
ne 国 -- 
| 
处 理 时 间 
| 
空闲 时 间 





图 10-3 ” 当 请 求 1 等 待 男 一 个 进程 结束 时 ， 两 个 其 他 的 请 求 会 被 处 理 
在 代码 清单 10-1 中 的 阻塞 方法 中 ,简单 地 添加 一 个 回调 函数 到 Meteor 不 会 改变 我 们 观察 到 的 
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行为 ， 因 为 方法 在 完成 之 前 不 会 等 竺 回调 函数 。 相 反 ,， 方法 将 从 上 到 下 处 理 ， 并 将 结果 返回 到 方 
法 的 调用 方 。 代 码 清 单 10-2 显 示 了 更 新 过 的 函数 setTimeoutFor3s, 它 使 用 setTimeout 来 将 自 
己 的 执行 延迟 3 秒 。 


代码 清单 10-2 ”使 用 模拟 延迟 的 非 阻 塞 方法 








setTimeoutFor3s = function(value) { < 一 
var result = value; 这 需要 一 些 
setTimeout (function(){ 时 间 来 完成 


result += 3; 

console.log('Result after timeout', result); 
}, 3000); 
return result; 


} 


Meteor.methods({ 
'nonBlockingMethod': function(){ 
console.log('Method.nonBlockingMethod'); 


var returnValue = 0; 这 将 总 是 打印 0， 因 为 
Se 0 

returnValue = setTimeoutFor3s (returnValue); Meteor 不 会 等 竺 

console.log('resultComputation', returnValue); 了 | setTimeout 完 成 


return returnValue; 
je 
首先 ， 这 个 方法 调用 将 被 添加 到 事件 循环 中 并 被 处 理 。setTimeout 函 数 也 被 添加 到 事件 循 
环 , 但 它 会 被 延迟 , 并 且 在 原来 的 方法 已 经 完成 以 后 才 会 被 处 理 。 这 解释 了 为 什么 该 方法 的 返回 
值 为 0， 只 有 在 3 秒 以 后 正确 的 结果 3 才 会 被 打印 出 来 (图 10-4 )。 因 为 该 方法 已 经 运行 完成 ， 所 以 
它 不 能 返回 结果 。 因 此 ， 该 方法 不 能 基于 返回 值 做 任何 事情 。 





















































1 .方法 调用 
| 服务 器 端 日 志 输 出 
Eeeaaaaaaaaaaaaasaaaae > 12:00:00.100(2)? Method.nonBlockingMethod 
超时 | 
| 
l 
Er 12:00:00.100(2)? resultComputation 0 
ES 12:00:03.100(2)? Result after timeout 3 
es 3. setTimeout 
返回 什 回调 函数 
0 1 六 4 六 





2 
事件 循环 ( 秒 ) 
图 10-4 ”setTimeout 回 调 函 数 是 事件 循环 的 一 个 新 函数 


现在 你 已 经 看 到 什么 是 行 不 通 的 。 下 一 节 介 绍 了 在 服务 器 端 使 用 异步 函数 的 一 些 不 同方 法 。 
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通常 你 需要 能 够 在 方法 调用 中 执行 一 个 异步 任务 并 能 
Meteor 有 一 些 不 同 的 方法 来 实现 异步 代码 ， 它 们 都 依赖 


10.2 ”使 用 纤维 的 异步 功能 


在 Meteor 中 ， 每 个 方法 都 在 一 个 纤维 内 运行 (参见 10.2.1 节 的 定义 ), 其 中 的 原因 是 : 和 正常 
的 Nodejs 编 程 比 起 来 , 它 有 更 多 的 同步 编码 风格 。 Node.js 的 一 个 问题 是 , 你 经 常 碰 到 所 谓 的 金字 
塔 厄运 或 回调 地 狱 。 这 是 因为 在 事件 循环 中 ,每 个 函数 调用 都 被 注册 为 一 个 异步 回调 。 例 如， 如 
果 你 创建 一 个 到 数据 库 的 连接 、 执 行 一 个 查询 、 调 用 一 个 外 部 API, 然后 保存 结果 并 返回 一 个 值 ， 
最 后 你 会 有 五 个 回调 函数 一 在 一 起 。 让 我 们 来 看 看 以 下 代码 清单 中 的 伪 代 码 。 


代码 清单 10-3 ”厄运 金字 塔 





够 处 理 结果 ， 然 后 将 其 发 送 给 客户 端 。 
于 纤维 ( fiber )。 



























































连接 到 





数据 库 在 数据 库 中 查 
DB.connect (options, function(err, connection)f{ < 一 询 一 个 文档 
connection.query (something, function(err, document)f{ < 一 一 
ExternalAPI.makeCall (document, functionl(err, apiResult)f{ < 
connection.save(apiResult, function(err, saveResult){ < 一 查询 外 部 的 
request.end(saveResult); < 一 API 
1 
ee 通过 初始 请 求 将 调用 的 结 
i 将 结果 发 送 给 果 保存 到 数 
调用 用 户 
首先 ， 你 创建 一 个 到 数据 库 的 连接 ， 然 后 查询 数据 库 中 的 文档 。 这 可 能 会 返回 用 户 的 Twitter 





句柄 。 接 下 来 是 一 个 API 查 寻 ， 让 我 们 假设 你 要 获得 花 的 数量 。 这 个 数字 将 被 存储 在 数据 库 中 ， 
最 后 结果 返回 给 发 起 请 求 的 用 户 。 现 在 想象 一 下 ， 如 果 要 添加 额外 的 代码 来 执行 一 些 处理 , 代码 
清单 10-3 看 起 来 会 是 什么 样子 ?” 这 将 是 一 个 维护 的 璐 梦 。 幸 运 的 是 ，Meteor 会 防止 你 使 用 这 种 复 
杂 的 结构 。 


10.2.1 将 多 任务 引入 事件 循环 


本 质 上 Node.js 使 用 一 个 线程 来 做 所 有 的 事情 。 这 是 伟大 的 , 因为 它 避 免 了 多 线程 环境 中 所 有 
丑陋 的 方面 , 但 它 需 要 一 个 解决 方案 来 并 行 处 理事 情 。 像 和 尚 一 样 做 完 一 件 事 再 做 另 一 件 事 ,， 作 
为 个 人 生活 的 选择 是 伟大 的 , 但 服务 器 通常 需要 在 同一 时 间 处 理 多 个 请 求 , 尤其 是 有 多 个 处 理 器 
在 等 待 做 事情 的 时 候 。 

纤维 是 在 Node.js 中 低 开 销 引 入 轻 量 级 线程 特性 的 一 种 可 能 .有 几 个 用 于 处 理 长 时 间 运 行 任务 
或 并 行 任务 的 概念 ， 如 名 ture 、promise 或 前 面 看 过 的 回调 函数 。 由 于 Meteor 严 重 依赖 于 纤维 ， 我 
们 将 把 讨论 限制 在 它们 之 上 。 事 实 上， 纤维 是 Meteor 流 行 的 主要 原因 之 一 。 为 了 解释 它们 是 如 何 
工作 的 ， 我 们 先 来 看 看 两 个 主要 的 多 任务 模式 。 
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1. 抢占 式 和 协同 式 多 任务 

为 了 协调 多 任务 , 通常 使 用 一 个 中 央 调 度 程序 来 为 线程 分 配 CPU 时 间 。 调 度 程序 有 权 在 合适 
的 时 候 暂 停 和 恢复 线程 。 有 了 这 种 抢占 式 多 任务 处 理 方 法 ,资源 可 以 在 进程 之 间 平 衡 地 使 用 。 不 
幸 的 是 , 调度 程序 不 知道 什么 时 候 该 暂停 一 个 任务 ,恢复 男 一 个 任务 。 如 果 一 个 线程 需要 大 量 的 
处 理 需 资源 ， 但 调度 程序 切换 到 另 一 个 线程 ， 而 另 一 个 线程 却 需要 等 待 一 个 LO 操作 完成 ， 这 样 
就 不 是 很 有 效 。 

在 一 个 进程 的 上 下 文中 , 很 容易 确定 一 个 任务 是 否 正 在 等 待 另 一 个 操作 的 结果 ( 例如, 调用 
一 个 远程 API 或 写 和 数据库 ) 并 将 CPU 时 间 转 移 给 另 一 个 就 绪 的 任务 。 这 就 是 所 谓 的 协同 式 多 任 
务 。 每 个 合作 线程 可 能 会 在 需要 等 待 的 时 候 为 别 的 线程 让 路 ( 也 就 是 说 ， 把 资源 给 别 的 线程 )。 
这 不 同 于 通常 使 用 的 抢占 式 多 任务 ( 例如 ， 当 操作 系统 的 调度 程序 决定 一 个 线程 必须 给 男 一 个 线 
程 资源 时 )。 

2. 纤维 和 事件 循环 

纤维 在 事件 循环 中 引入 协作 式 多 任务 处 理 。 它 们 只 用 在 服务 器 端 , 不 能 在 浏览 器 中 使 用 。 纤 
维 有 时 被 称 为 绿色 的 线程 , 因为 纤维 不 像 普通 线程 那样 由 操作 系统 调度 , 而 是 由 单线 程 的 Node.js 
服务 器 管理 的 。 

你 基本 不 需要 在 Meteor 应 用 中 创建 纤维 ， 因 为 它们 内 置 在 这 个 平台 上 ， 纤 维 会 被 自动 使 用 。 
默认 情况 下 ,Meteor 为 每 个 DDP 连 接 创 建 一 个 专用 的 纤维 。 由 于 每 个 客户 端 使 用 一 个 DDP 的 连接 ， 
你 可 以 说 它 为 每 个 客户 创建 一 个 纤维 。 

代码 清单 10-3 显 示 了 每 个 回调 函数 如 何 使 金字 塔 变 得 越 来 越 大 。 为 了 避免 这 种 情况 ,你 可 以 
把 所 有 的 函数 封装 在 一 个 纤维 内 ( 见 下 面 的 代码 清单 )。 


代码 清单 10-4 ”使 用 纤维 以 避免 厄运 金字 塔 
Fiber (function(){ 
Var connection, document, apiResult, saveResult = null; 







































































DB.connect (options, function(err, con)t{ 
connection = con; 


ye 


connection.query (something, function(err, doc)t 
document = doc; 
区 


ExternalAPI.makeCall (document, function(err, res){ 
apiResult = res; 

过 
connection.save(apiResult, function(err, res)t 
saveResult = res; 

Py) 


request .end(saveResult); 


}) .run() 
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代码 清单 10-4 中 的 代码 看 起 来 更 容易 明白 。 即 使 使 用 异步 函数 ,一 个 纤维 内 的 执行 也 是 同步 
的 。 同 步 执行 不 会 影响 或 阻塞 其 他 纤维 ( 参见 图 10-5 ) 一 一 再 也 看 不 见 金字 塔 了 。Meteor 在 幕后 
使 用 了 完全 相同 的 方法 。 








connection.query connection.save 
DB.connect | ExternalAPIl .makeCall | | 
而 1 
! 1 
1 1 
































默认 情况 下 ，Meteor 等 待 《空间 CPU 时 间 ) 

为 每 个 客户 端 创建 一 

个 纤维 _ 
0 10 20 30 一 





事件 循环 (毫秒 ) 
图 10-5” 对 每 个 DDP 连 接 ，Meteor 在 事件 循环 中 使 用 一 个 纤维 


即使 你 没有 意识 到 ， 你 每 次 在 一 个 服务 器 方法 中 使 用 fina() 查找 集合 记录 时 ， 实 际 上 执行 
了 一 个 非 阻塞 的 数据 库 查 询 : 


var user = Meteor.users.findone({name: 'Michael'}); 
return user.name; 


要 访问 数据 库 并 返回 结果 ，Meteor 会 自动 地 将 指令 包 在 纤维 中 。 这 样 做 的 缺点 是 : 使 用 异步 
的 外 部 API 变 得 更 加 复杂 。 在 10.1.2 节 ， 我 们 看 了 一 个 简单 的 例子 ， 在 那里 我 们 使 用 setTimeout 
来 模拟 一 个 异步 函数 调用 。 不 幸 的 是 , 在 异步 调用 之 前 ,该 方法 已 经 完成 并 返回 了 一 个 值 。 要 改 
变 这 一 点 ， 可 以 使 用 纤维 。 

你 可 以 通过 三 个 命令 与 Meteor 内 部 使 用 的 纤维 进行 交互 ( 参见 图 10-6 )。 
口 wrapAsync 为 当前 纤维 附加 一 个 回调 函数 。 
口 unblock 一 一 允许 单个 纤维 内 的 多 个 操作 并 行 执 行 。 
口 pindEnvironment 一 一 创建 一 个 新 的 纤维 来 维持 当前 的 环境 (例如 ， 全 局 变量 的 值 )。 
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bindEnvironment 

wrapAsync 附 加 一 个 unblock 为 后 续 的 方 创建 一 个 新 的 纤维 
可 调 函数 到 当前 纤维 法 调用 创建 新 的 纤维 并 复制 当前 的 环境 

默认 情况 下 ， 

Meteor 为 每 个 客 

户 端 创建 一 个 纤 

维 ， 但 可 能 会 在 结果 

需要 的 时 候 使 用 方法 调用 结果 方法 调用 

额外 的 纤维 























0 50 100 150 200 250 300 
事件 循环 (毫秒 ) 
图 10-6 ”使 用 纤维 进行 异步 调 












































二 














10.2.2 使 用 wrapAsync 为 纤维 绑 定 回调 函数 


Meteor 为 每 个 客户 请 求 创建 一 个 新 的 纤维 , 所 以 你 可 以 假设 所 有 的 代码 都 已 经 在 纤维 内 运行 
但 回调 函数 跑 出 了 纤维 , 在 它 返 回 结果 的 时 候 已 经 没有 以 前 的 上 下 文 了 (比如 哪个 用 户 最 先 

发 出 请 求 )。 因 此 ， 在 Meteor 中 一 个 常见 的 错误 消息 是 “Meteor 的 代码 必须 始终 在 一 个 纤维 中 运 
行 ”。 处 理 回 调 函 数 时 ， 你 可 以 使 用 Meteor .wrapAsync 限 数 以 确保 从 回调 函数 返回 的 结果 依然 
在 于 一 个 给 定 的 纤维 内 。 可 以 使 用 函数 wrapaAsync 把 其 他 任何 函数 封装 到 一 个 纤维 中 。 如 果 没 
有 传递 一 个 回调 函数 作为 参数 ， 它 将 同步 地 调用 函数 。 否则， 它 实际 上 是 异步 的 。 只 有 提供 一 个 
回调 函数 时 ，Meteor 才 能 恢复 原始 冰 数 被 调用 时 的 环境 ， 有 效 地 将 结果 放 在 同一 个 纤维 中 。 

代码 清单 10-5 显 示 了 一 个 更 新 的 方法 wrapAsyncMethod， 我 们 即将 要 调用 它 。 在 该 方法 中 
调用 了 一 个 带 有 回调 函数 的 异步 晴 数 。 在 纤维 的 帮助 下 ， 等 待 异步 函数 完成 ， 然 后 运行 方法 , 返 
回 正确 的 值 ， 这 是 可 能 的 。 这 个 辅助 函数 在 当前 纤维 自动 运行 异步 函数 (参见 图 10-7 )。 


代码 清单 10-5 ”使 用 wrapasync 调 用 也 数 


setTimeoutFor3sCb = function (value, cb) { 

var result = value; 

Meteor.setTimeout (function () { 
console.log('Result after timeout', result); 
cb(null, result + 3) 

} 3000) 

} 
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Meteor.methods({ 


'wrapAsyncMethod': function () { 
console.log('Method.wrapAsyncMethod'); 


Var returnValue = 0; 


returnValue = 


console.log('resultComputation', 


return returnValue; 


} 
es 


Meteor.wrapAsync (setTimeoutFor3sCb) (returnValue); 


returnValue); 


“| 返回 3 


说 明 wrapaAsync 以 一 个 标准 的 回调 函数 为 最 后 一 个 参数 ， 回 调 函 数 有 错误 和 回应 两 个 参数 : 


CallbackFunction 


1. 方 法 调用 


err, result ){}。 


服务 器 端 输出 








汪汪 下 和 12:00:00.045(2)? Method.wrapAsyncMethod 





























超时 
2.setTimeout 辆 -一 ----- 12:00:03.047(2)? Result after timeout 0 
可 调 函 数 时 -------------------- 12:00:03.047(2)? resultComputation 3 
3. 方 法 返 和 
梧 值 0 1 2 3 4 5 











图 10-7 





hll 


件 循环 (毫秒 ) 
使 用 wrapaAsync 等 竺 回调 函数 提供 方法 的 返回 值 




















10.2.3 ”为 单个 客户 端 解除 方法 调用 阻塞 


如 果 你 调用 一 个 方法 , 它 
行 , 你 希望 在 同一 个 容 户 端 } 








它 可 以 执行 几 个 任务 。 男 一 方面 , 很 多 时 候 多 个 任务 由 不 同 的 方法 执 





F 行 调用 多 个 方法 。 正 如 你 所 知道 的 ,每 个 客户 端 都 有 一 个 相关 的 纤 
运行 ， 即 某 个 时 间 只 有 一 个 在 运行 。 如 果 客 户 端 调用 methogA 然 后 调 








维 ， 每 个 方法 在 纤维 中 同步 运行 ， 








用 methodB,， 


让 我 们 假设 你 两 次 调用 一 个 方法 (在 同一 个 浏览 


默认 的 行为 是 在 调用 methodB 之 前 等 待 nethogdA 完 成 。 





妖 中 )， 而 被 调用 的 方法 是 一 个 阻塞 的 长 时 


间 运 行 的 方法 ， 如 下 面 的 代码 清单 所 示 。 


代码 清单 10-6 ”顺序 执行 方法 


block = function(value, cb) { 


Meteor .setTimeout ( 
cb(null, true); 
}, 3000); 
} 


function(){ 
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Meteor .methoqs ({ 

'sequential': function (value) { 
console.log('Method.sequential', value); 
Meteor.wrapAsync (block) (value); 
console.log('Method.sequential returns', value); 
return true; 

} 

3 


在 浏览 器 控制 台中 ， 你 现在 可 以 这 样 发 出 两 个 方法 调用 : 


Meteor.call('sequential', 'first', functionl(err,res)t{ 
console.log('done first'); 
es 


Meteor.call('sequential', 'second', functionl(err,res)t 
console.log('done secondq' ) ; 
}); 





你 注意 到 什么 了 吗 ? 在 这 个 例子 中 ， 方 法 被 顺序 调用 。 第 一 个 回调 函数 在 3 秒 后 执行 ， 
个 回调 函 Ce es 要 以 并 和 
中 使 用 this. unblockl( 











AAA 
2 


I 





的 方式 立即 执行 这 两 个 方法 ， 你 可 以 在 该 方法 





端 进行 了 额外 ee 使 用 unblock 将 允许 Meteor 创 建 一 个 新 的 纤维 。 
代码 清单 10-7 ”使 用 unblocki 让 其 他 函数 继续 运行 


待 另 


Meteor .methoqs ({ 
unblock: function(value) 


ee 这 调用 this.unblock 
n ; od.unblock', value); A 
A 允许 客户 端 立刻 
运行 另 一 个 弛 名 
this.unblock(); 运行 另 一 个 纤维 
Meteor .wrapAsync (block) (value); 
console.log('Method.unblock returns', value); 
return value; 
} 
上 





， 如 代码 清单 10-7 所 示 。 如 果 一 个 方法 仍然 在 等 待 结果 ， 而 同一 个 客户 


在 这 种 情况 下 ， 两 个 方法 将 立即 运行 ， 两 个 回调 函数 将 在 3 秒 后 运行 。 两 个 方法 都 不 需要 等 


一 个 完成 。 可 在 浏 a call 来 调用 这 个 方法 进行 测试 。 





正如 你 在 图 10-8 中 看 到 的 ,调用 sequential 方 法 将 运行 第 一 个 请 求 ,3 秒 后 运行 第 二 个 请 求 ， CE 


而 unplock 方 法 能 立即 运行 两 个 请 求 。 
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@9e@ 时 app 

MacBook:app stephan$ meteor 

[IEC 
~/Documents/Code/github/meteorinaction/production/ch18-advancedservermethods/app 
111]]] 
| 





|=> Started proxy. 
|=> Started MongoDB. 


当 第 一 个 方法 完 | => Started your app. 
成 时 第 二 个 方 | => App running at: http://\localhost:3000/ 
9 一 中 | I20158426-18:12:33.181(2)? Method.sequential first 
站 1 人 8426[18:12:36.119(2)?|Method. sequential returns first 
站 
法 调用 开始 IT29159426+18:12:36.111(2)?jMethod.sequentiat second 
| I28158426-18:12:39.115(2)? Method.sequential returns second 


| I29159425{18:12:55.384(2)? 了 |Method.unbtock first 
这 两 个 函数 都 | I20150426t18: 12:55.384(2)?)Method.unblock second 
| I28158426-18:12:58.389(2)? Method.unblock returns first 









在 同一 时 间 被 | I28158426-18:12:58.389(2)? Method.unblock returns second 
调用 ' 








图 10-8 ”顺序 运行 方法 和 使 用 unblock 运 行 方法 


10.2.4 ”使 用 bindEnvironment 创建 纤维 


对 于 某 些 操作 ， 访 问 进行 异步 函数 调用 的 环境 是 很 重要 的 。 让 我 们 假设 你 添加 了 accounts 
包 ， 你 想 在 一 个 简单 的 方法 中 访问 当前 userId。 只 要 以 异步 的 方式 来 做 这 件 事 ， 容 易 这 样 做 : 

Meteor.userId() 

在 一 个 方法 的 范围 中 可 以 读 取 userIg 的 值 就 够 了 ， 因 为 Meteor 会 自动 将 各 种 变量 附加 到 纤 
维 上 。 方法 允许 你 通过 this 来 访问 它 被 调用 时 的 环境 。 通 过 这 个 调用 对 象 ， 可 以 访问 不 同 的 属 
性 和 函数 ， 比 如 this.userIda， 它 和 调用 这 个 方法 的 用 户 相关 。 如 果 调 用 一 个 在 当前 纤维 之 外 
运行 的 函数 ， 你 将 失去 对 这 些 环境 变量 的 访问 。 

调用 异步 函数 setTimeoutFor3sCb 时 ， 它 需要 3 秒 的 时 间 返 回 结 果 ， 原 始 的 调用 环境 在 回调 
函数 中 已 经 丢失 了 。 突 然 this 失 去 了 对 userIgd 的 访问 ， 因 为 它 涉及 全 局 对 象 而 不 是 调用 对 象 ”。 
这 就 是 第 一 个 console.log 可 以 在 终端 打印 出 当前 用 户 了 DD 而 第 二 个 打印 导致 错误 的 原因 : 
“Meteor.userId 只 能 在 方法 调用 中 使 用 。” 为 了 说 明 这 个 问题 ， 看 看 下 面 的 代码 清单 。 
代码 清单 10-8 ”在 方法 的 回调 函数 中 使 用 Meteor .userid() 


Meteor .methoqs ({ 
























































'unboundEnvironment': function () { 打印 调用 
console.log('Method.unboundEnvironment: ', Meteor.userId()); 该 方法 的 
用 户 ID 


setTimeoutFor3sCb(2, function () { 
console.log('3s later: ', Meteor.userId()); < 


2 生成 一 个 
] 着 误 消息 


和 
在 方法 中 使 用 异步 函数 时 , 如 果 需 要 访问 当前 的 环境 , 可 以 使 用 Meteor 的 bindEnvironment 





Q@ 对 于 JavaScript 中 this 关 键 词 更 深入 的 解释 ， 可 参考 http://stackoverflow.com/questions/133973/how-does-thiskey- 
word-work-within-a-JavaScript-object-literal。 
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函数 。binqEnvironment 创 建 一 个 纤维 并 自动 地 附加 正确 的 环境 。 在 我 们 的 例子 中 ， 如 代码 清 
单 10-9 那 样 修改 方法 就 足够 了 。 整 个 回调 函数 被 包 在 一 个 Meteor .pbindEnvironment () 块 中 。 


代码 清单 10-9 ”在 方法 中 ， 在 绑 定 的 回调 函数 中 使 用 Meteor .useria() 





Meteor.methods ({ 将 方法 的 当前 
'bindEnvironment': function () { 环境 绑 定 到 
console.log('Method.bindEnvironment: ', Meteor.userId()); 回调 函数 

setTimeoutFor3sCb(2, Meteor.bindEnvironment (function () { < 二 


console.log('Method.unboundEnvironment (3s delay): '!，Meteor.userId () ) ;< 一 
J 


| 打印 调用 方法 
1 的 用 户 ID 
图 10.9 显 示 了 未 绑 定 和 已 绑 定 环境 的 调用 。 因 为 Meteor.useria 的 值 在 回调 函数 中 丢失 了 ， 
所 以 未 绑 定 的 例子 抛 出 一 个 错误 消息 ， 而 第 二 调用 绑 定 的 方法 调用 成 功 。 
从 一 个 长 期 运行 的 方法 回调 函 
数 中 调用 Meteor .userId， 
将 导致 一 个 错误 



































@e@e 转 methods 





=> Started your app. 


=> App running at: http:/Alocalhost:3000/ 

I28158327-08:14:16.458(1)?\Method.unboundEnvironment: m7mdiYbZkw99KTYKP 

TI29150327-98:14:19.410(1)? Exception in setTimeout callback: Error: Meteor.userId can only be invoked in method 
calls. Use this.userId in publish functions. 

I29150327-98:14:19.411(1)7 

IT29150327-98:14:19.411(1)7 

I29159327-98:14:19.411(1)7 

I29159327-98:14:19.411(1)7 

I29159327-98:14:19.411(1)? 

I29159327-98:14:19.411(1)? 
128150327-08:14:39.824(1)? 

[easeaz7-as: 14:42.828(1)? 





at Object.Meteor.userId (packages/accounts-base/accounts_server.js:19:1) 
at app/methods.js:129:70 
at app/methods.js:163:7 
at [object Object]._.extend. the lue (packages/meteor/dynamics_nodejs.js:56:1) 
t packages/meteor/timers. js:6 
at\runWithEnvironment ey nodejs.js:198:1) 
Method.bindEnvironment: m7mdiYbZkw99KTYKP 
Method.bindEnvironment (3s delay): m7mdiYbZkw99KTYKP 
































































































































A 

在 bindEnvironment 中 在 一 个 未 绑 定 的 下 使 用 bindEnvironment， 

使 用 Meteor.userId 调 函 数 中 使 用 Meteor .userId 在 回调 函 
Meteor.userId 数 中 是 可 。 




















5| 





图 10-9 在 一 个 没有 绑 定 环境 的 回调 函数 中 访问 Meteor .userId 会 导致 错误 


大 多 数 时 候 , 对 调用 异步 函数 而 言 , 使 用 wrapaAsync 就 足够 了 。 只 有 当 你 需要 访问 给 定 的 环 
境 , 但 不 能 将 所 有 需要 的 变量 传递 给 函数 调用 时 , 才 应 该 使 用 pindEnvironment。 大 多 数 时 候 ， 
使 用 wrapAsync 就 可 以 于 各 

回头 看 看 第 7 章 ， 在 那里 我 们 讨论 了 将 汇总 数据 发 布 到 客户 端 。 在 这 种 情况 下 ， 为 了 确保 发 
布 不 会 被 等 待 MongoDB 的 结果 所 阻塞 ， 我 们 也 不 得 不 使 用 binqEnvironment。 



































10.3 整合 外 部 API 


许多 应 用 依赖 于 外 部 的 API 来 获取 数据 。 从 Facebook 获 取 关 于 你 朋友 的 信息 、 查 询 你 所 在 地 
区 目前 的 天 气 , 或 简单 地 从 男 一 个 网 站 获取 头像 一 一 整合 额外 的 数据 有 许多 用 途 。 它们 都 面临 一 








208 第 10 章 高 级 服务 器 方法 








个 共同 的 挑战 .如果 必须 从 服务 器 调用 API， 调 用 API 通 常 比 运行 该 方法 要 花费 更 多 的 时 间 。 你 
已 在 前 一 节 看 到 如 何在 理论 上 处 理 这 个 问题 ， 现 在 我 们 通过 HTTP 整 合 一 个 外 部 API 调 用 。 

基于 访问 者 的 IP 地 址 ， 你 可 以 获得 他 们 当前 位 置 的 各 种 信息 ， 如 坐标 、 城 市 或 时 区 。 有 一 个 
简单 的 API， 可 通过 IPv4 地 址 返回 一 个 包含 所 有 这 些 内 容 的 JSON 对 象 ， 这 就 是 所 谓 的 Telize 


(www.telize.com )。 




































































10.3.1 使 用 HTTP 包 进 行 RESTful 调用 


要 与 外 部 RESTful API ( 如 Telize ) 进行 沟通 ， 你 需要 添加 http 包 : 

$ meteor add http 

虽然 http 包 可 以 让 你 从 客户 端 和 服务 器 端 进行 HTTP 调 用 ， 本 例 中 的 API 调 用 将 只 在 服务 器 
端 进行 。 许 多 API 要 求 你 提供 卫 及 密 钥 以 识别 发 送 API 请 求 的 应 用 。 虽 然 在 此 例 中 你 不 需要 任何 
凭证 ,但 在 许多 其 他 情况 下 你 会 需要 这 些 ， 然 后 才能 从 服务 器 上 发 出 请 求 。 这 样 ， 你 永远 不 必 在 
客户 端 共享 密 钥 。 图 10-10 解 释 了 其 中 的 基本 概念 。 一 个 用 户 请 求 某 耻 地 址 的 位 置信 息 (步骤 1 )。 
客户 端 应 用 调用 一 个 服务 器 方法 geoJsonforIp (步骤 2 )， 它 使 用 HTTP .get () 方 法 异步 调用 外 
部 的 API (步骤 3 )。 响 应 ( 步 又 4 ) 是 一 个 与 IP 地 址 相关 的 地 理 位 置信 息 的 JSON 对 象 ， 它 通过 回 
调 函 数 被 发 送 回 客户 端 (步骤 5 )。 















































外 部 API 






每 个 客户 端 异步 


调用 第 三 方 API ~、 人 a 


4. JSON 形 式 3. 对 API URL 调 用 




















的 响应 HTTP .get () 1， 清 求 某 IP 

的 地 址 
pe i 2. 调用 geoJsonForIp|} SANT 

方法 | 
| DDP 应 用 

| 5 在 回调 函数 | 
5-------------- 中 返回 响应 2 -| 

服务 器 客户 端 


图 10-10 ”调用 外 部 API 时 的 数据 流 





10.3.2 ”使 用 同步 方法 查询 API 


让 我 们 添加 一 个 方法 在 telize.com 中 查询 某 个 给 定 的 IP 地 址 ， 如 代码 清单 10-10 所 示 。 此 示例 
只 包括 查询 一 个 API 的 基本 要 素 。 
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代码 清单 10-10 “使 用 同步 方法 查询 外 部 的 API 

Meteor .methoqs ({ 该 方法 接受 一 个 

'geoJsonForIp': function (ip) { < 合法 的 IPv4 地 址 
console.log('Method.geoJsonForIp for', ip); 


Var apiUrl = 'http://ww.telize.com/geoip/' + ip; 构建 
Var response = HTTP.get (apiUrl1) .data; < 一 API URL 
return response; 查询 

} 接口 





} 
一 旦 该 方法 在 服务 器 上 可 用 , 就 在 客户 端 调 用 带 有 回调 函数 的 方法 来 查询 一 个 下地 址 的 位 置 : 
Meteor.call('geoJsonForIp', '8.8.8.8', function(err,res)t{ 


console.log (res); 
}); 


虽然 这 个 解决 方案 看 起 来 是 可 以 工作 的 ， 但 它 有 两 个 主要 的 缺陷 。 

口 如 果 该 API 的 响应 速度 慢 ， 那 么 请 求 将 开始 排队 。 

口 如 果 这 个 API 返 回 一 个 错误 ， 就 没有 办 法 返回 到 用 户 界面 。 

要 解决 排队 的 问题 ， 可 以 在 方法 中 添加 一 个 unblock () 语 句 : 

this.unblock(); 

正如 你 从 前 面 的 章节 中 知道 的 ， 调 用 一 个 外 部 API 应 该 总 是 异步 完成 。 这 样 ， 你 也 可 以 将 可 
能 的 错误 值 返回 到 浏览 器 , 这 将 解决 第 二 个 问题 。 让 我 们 创建 一 个 专用 的 函数 用 于 异步 API 调 用 ， 
如 此 以 保持 方法 本 身 的 干净 。 


10.3.3 ”使 用 异步 方法 调用 API 
代码 清单 10-11 显 示 了 如 何 调 用 HTTP .get 方 法 并 通过 回调 函数 返回 结果 。 它 还 包括 可 以 在 客 
户 端 上 显示 错误 的 处 理 程序 。 


代码 清单 10-11 用 于 异步 API 调 用 的 专用 函数 









































var apiCall = function (apiUrl, callback) { try...catch 允 许 
try 汪 了 | 你 处 理 错误 
Var response = HTTP.get (apiUrl1) .data; 
callback (null, response); < 一 ‘器 
一 个 成 功 的 API 调 用 不 会 返回 错误 ， 
ae = 和 
但 是 会 返回 JSON 响 应 的 内 容 
if (error.response) { 全 一 一 如 果 API 响 应 是 一 个 错误 
Var errorCode = error.response.data.code; Ni i ; 
其 背 误 代码 和 错 
Var errorMessage = error.response.data.message; ee 吴 代 码 和 错 
误 消息 
} else { 
Var errorCode = 500; 否则 使 用 一 个 通用 
Var errorMessage = 'Cannot access the API'; 的 错误 消息 


} 
Var myError = new Meteor.Error(errorCode, errorMessage); | 创建 一 个 错误 对 象 


callback (myError, null); 并 通过 回调 函数 返 
回 它 
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在 try. . .catch 块 中 ， 你 可 以 区 分 成 功 的 调用 (try 块 ) 和 失败 的 调用 (catcn 块 ),。 成 功 
的 调用 中 ， 回 调 孔 数 的 错误 对 象 可 能 是 nul1; 失败 时 将 返回 错误 ( error ) 对 象 ， 而 实际 啊 应 将 
为 null。 

错误 有 各 种 类 型 ， 你 想 区 分 以 下 两 种 错误 : 一 是 API 访 问 错误 ， 男 一 个 是 API 调 用 返回 的 响 
应 中 包含 错误 。 这 就 是 if 语句 检查 的 目的 : 如果 error 对 象 有 response 属 性 ， 可 以 从 中 获得 错 
误 代 码 和 错误 消息 ; 否则 ， 你 可 以 显示 一 个 通用 的 错误 500， 即 无 法 访问 该 API。 

对 于 每 种 情况 ,无 论 成 功 还 是 失败 ， 都 将 返回 一 个 可 以 回 传 到 用 户 界面 的 回调 函数 。 要 进行 
异步 API 调 用 , 你 需要 如 代码 清单 10-12 显 示 的 那样 更 新 方法 。 改 进 的 代码 对 方法 进行 解锁 ,并 把 
API 调 用 包 在 wrapAsync 畏 数 中 。 


代码 清单 10-12 更 新 过 的 进行 异步 API 调 用 的 方法 















































Meteor.methods({ 避免 阻塞 其 他 
'geoJsonForIp': function (ip) { 方法 调用 
this.unblock(); < 一 
var apiUrl = 'http://www.telize.com/geoip/' + ip; 
Var response = Meteor.wrapAsync (apiCall) (apiUr1) : < 一 
return response; 异步 调用 专用 
} 的 API 调 用 函数 


学 

最 后 , 为 了 允许 来 自 浏览 器 的 请 求 并 显示 错误 消息 , 你 应 该 添加 一 个 类 似 于 下 面 代码 清单 中 
的 模板 。 

代码 清单 10-13 ”用 于 API 调 用 和 显示 错误 的 模板 


<template name="telize"> 

















<p>Query the location data for an IP</p> 设置 数据 

<input id="ipv4" name="ipv4" type="text" /> 上 下 文 如 果 位 置 有 一 个 错 

<button>Look up location</button> 误 属 性 ， 显 示 错 误 
: | 类 型 和 消息 

{{#with location}} < 一 


{{#if error}} 
<p>There was an error: {{error.errorType}} {{error.message}}!</p> 


{{else}} 
<p>The IP address {{location.ip}} is in {{location.city}} 
({{location.country}}) .</p> 
[区 AS] 村 
{{/with}} 
</template> 


代码 清单 10-14 显 示 了 连接 模板 和 方法 调用 的 JavaScript。session 变 量 1location 用 于 存储 
API 调 用 的 结果 。 单 击 按钮 将 获取 输入 框 的 内 容 ， 并 将 其 作为 参数 发 送 给 geoJsonForIp 方 法 。 
最 后 Session 变 量 设置 为 回调 函数 的 返回 值 。 


代码 清单 10-14 ”用 于 API 调 用 的 模板 辅助 函数 


Template.telize.helpers({ 
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location: function () { 
return Session.get('location'); < 一 


} API 响 应 存储 
}); 在 会 话 变量 中 
Template.telize.events(({ 

'clicek Dutbtton7: function (evts tpl) € 

var ip = tpl.find('input#ipv4') .value; 
Meteor.call('geoJsonForIp', ip, function (err, res) { 
if (err) { 


Session.set('location", terror:, rr})3 一 方法 调用 将 会 话 变 量 设 
} else { 置 为 回调 函数 的 返回 值 
Session.set('location', res); -一 





return, Fes 
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虽然 上 传 文件 是 在 网 络 上 最 常用 的 功能 之 一 , 但 实现 这 一 功能 却 不 简单 。 你 可 以 在 不 同 的 地 
方 存 储 上 传 的 内 容 ( 参见 图 10-11 )， 每 个 选项 都 有 它 的 优点 和 缺点 。 
口 本 地 文件 系统 
口 远程 存储 
口 应 用 的 数据 库 














选项 A: 
本 地 文件 系统 


| 选项 B; 
外 部 存储 ， 
} 比如 S3 


选项 C: 
存储 在 数据 库 中 


图 10-11 Meteor 应 用 中 的 文件 存储 和 上 传 选项 


大 多 数 开发 人 员 发 现 ， 本 地 文件 系统 是 存储 文件 的 自然 解决 方案 〈 选项 A )。 它 已 经 在 那里 
了 , 也 相当 快 ， 而 且 只 要 空间 允许 可 以 容纳 尽 可 能 多 的 内 容 。 由 于 安全 性 和 性 能 的 原因 ,许多 托 
管 服务 提供 商 不 允许 访问 本 地 文件 系统 。 想 象 一 个 恶意 脚本 开始 写 几 百 兆 字 节 来 填 满 磁盘 空间 ， 
这 将 有 效 地 导致 该 实例 上 托管 的 所 有 应 用 拒绝 服务 。 在 实践 中 ， 这 意味 着 部 署 应 用 到 meteor com 
这 样 的 服务 上 时 ， 你 将 无 法 在 本 地 磁盘 上 存储 数据 ， 你 需要 把 文件 上 传 到 一 个 不 同 的 位 置 。 对 





文件 系统 
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Web 应 用 而 言 ， 一 个 更 好 的 解决 方案 是 应 用 和 数据 存储 的 分 离 。 

现在 云 存 储 提 供 商 〈 选 项 B ) 是 常见 的 ， 因 为 他 们 提供 了 很 多 的 优势 : 快速 而 且 高 度 可 用 ， 
而 且 宛 余 存 储 让 你 的 文件 更 安全 。 与 此 同时 ， 使 用 它们 建立 应 用 有 点 复杂 ， 而 且 可 能 是 昂贵 的 。 
云 存 储 提供 商 对 于 扩大 生产 环境 下 应 用 的 规模 是 个 好 的 选择 , 但 如 果 想 快速 地 看 到 结果 , 你 可 能 
要 考虑 男 一 个 选项 。 

第 三 种 可 能 是 在 应 用 的 数据 库 中 存储 文件 ( 选项 C ), 不 像 文件 系统 ,你 总 是 可 以 访问 它 , 并 
且 在 一 个 地 方 存放 所 有 的 数据 使 备份 很 容易 。 不 幸 的 是 ,使 用 数据 库存 储 文件 是 非常 低 效 的 ， 
为 它 很 缓慢 ， 而 且 与 保存 到 文件 系统 相 比 需要 大 得 多 的 空间 。MongoDB 被 设计 用 来 存储 文件 ， 
但 文件 最 大 不 能 超过 16MB 。 在 集合 中 存储 文件 需要 一 些 开 销 ， 所 以 实际 的 最 大 文件 大 小 约 为 
12MB。MongoDB 可 以 配置 为 使 用 GridFS 文 件 系 统 ， 它 允许 你 使 用 任何 大 小 的 文件 。 无 论 哪 种 方 
式 ， 它 仍然 是 一 个 存储 文件 低 效 但 方便 的 方式 。 

对 于 小 的 文件 ( 如 头像 ) 或 构建 原型 的 时 候 ， 数 据 库 是 一 个 可 行 的 选择 ， 它 给 了 开发 人 员 一 

最 具 移 植 性 和 最 简单 的 解决 方案 。 在 下 一 节 中 ， 你 将 实现 选项 C〈 对 于 实现 上 传 的 其 他 方式 ， 

请 参见 附注 栏 )。 





































































































有 用 的 文件 上 传 包 

虽然 在 数据 库 中 存储 文件 方便 并 且 萄 于 实现 ， 但 它 在 大 多 数 的 生产 方案 中 几乎 是 不 可 取 
的 。 为 了 更 好 的 性 能 和 可 扩展 性 ， 使 用 本 地 文件 系统 和 云 存储 服务 都 是 更 好 的 选择 。 

tomi :upload-servez 允 许 用 户 将 文件 上 传 到 本 地 文件 系统 ， 它 和 tomi :uploadjauery 
一 起 使 用 时 ， 可 提供 一 个 在 移动 设备 上 工作 良好 的 完整 的 用 户 界 面 ( 这 个 包 实 现 了 选项 A )。 

CollectionFS 带 有 各 种 存储 适配器 ,允许 你 在 本 地 文件 系统 中 存储 文件 ( cfs:filesys- 
tem )， 在 MongoDB 中 使 用 GridFS 文 件 系统 (cfs:grigdfs ) 或 在 S3 桶 中 存储 文件 (cfs:s3 ) 
(CollectionFS 可 以 用 来 实现 三 个 选项 中 的 任何 一 个 )。 

将 文件 上 传 到 云 服务 时 ,你 可 能 不 希望 先 将 文件 上 传 到 你 的 服务 器 ， 然 后 再 将 其 转发 到 实 
际 存储 中 。 客 户 也 可 以 直接 上 传 文件 到 谷歌 云 、Rackspace 或 其 他 云 。edgee:slingshot 包 实 
现 了 所 需 的 功能 ， 并 可 与 选项 B 一 起 工作 。 


将 文件 上 传 到 数据 库 


在 这 个 例子 中 ， 你 将 创建 一 个 模板 用 于 选择 文件 ,文件 将 被 直接 上 传 到 MongoDB 集 合 。 然 
后 , 文件 就 可 以 被 发 布 和 订阅 ， 就 像 任何 其 他 的 数据 库 内 容 一 样 。 图 像 数 据 将 以 Base64 编 码 格式 
存储 ， 这 样 在 浏览 器 中 显示 图 像 会 很 简单 。 

每 个 文件 文档 都 将 有 一 个 name 属 性 ， 文件 内 容 在 字段 base64 中 。 

1. 要 求 和 限制 

除了 通常 的 Meteor 组 件 一 一 应 用 和 数据 库 外 ， 上 传 文件 到 数据 库 没 有 额外 的 要 求 。 你 将 使 用 
浏览 器 中 的 HTML5 FileReader API 上 传 文件 ， 所 以 不 是 所 有 的 浏览 器 都 会 支持 ， 比 如 Internet 
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Explorer 8 和 Internet Explorer 9"。 


2. 模板 
上 传 文件 需要 的 只 是 一 个 input 元 素 。 你 甚至 不 需要 按钮 ， 因 为 一 个 文件 被 选中 时 可 以 立即 
开始 上 传 (代码 清单 10-15 )。 


代码 清单 10-15 上传 文 件 的 模板 代码 
<template name="upload"> 
<h2>Upload a file</h2> 
<input type="file" id="file-upload" /> 
</template> 




















<template name="file"> 
{{#with file}} 
<h2>{{name}}</h2> 
<img src="{{base64}}" /> 
{{/with}} 
</template> 
为 了 正常 显示 图 像 ， 你 需要 向 img 标 签 的 src 属 性 传递 一 个 URL。 因 为 这 个 图 像 不 能 从 URL 
访问 ， 所 以 你 也 可 以 直接 传递 Base64 编 码 的 内 容 到 src 属 性 。 要 从 集合 中 显示 多 个 图 像 ， 可 以 使 
用 {{#each}} 块 ， 就 像 处 理 任何 其 他 数据 库 内 容 一 样 。 
3. 将 发 布 限制 为 单个 文件 
第 一 步 是 创建 用 于 存储 文件 的 新 集合 : 


FilesCollection = new Mongo.Collection('files'); 


此 集合 应 在 客户 端 和 服务 器 上 都 可 用 。 运 行 meteor remove autopublish 避 免 将 所 有 文 
件 发 送 给 所 有 客户 。 这 个 集合 将 变 得 非常 大 ! 















































说 明 从 集合 中 发 布 文件 时 ， 注 意 ， 要 把 发 布 限 制 在 一 个 文件 上 ， 以 避免 发 送 数 百 兆 字 节 到 每 
个 连接 的 客户 端 。 











代码 清单 10-16 中 显示 了 建立 单个 文件 发 布 所 需 的 代码 。 所 请 求 的 文件 名 通过 一 个 Session 
变量 传 给 发 布 。 这 意味 着 一 次 只 有 一 个 图 像 可 以 显示 。 如 果 需 要 从 Filescollection 中 显示 多 
个 图 像 ， 你 必须 调整 函数 ， 让 它 来 处 理 一 个 名 字数 组 。 


代码 清单 10-16 发布 和 订阅 单个 文件 的 代码 
if (Meteor.isServer) { 
Meteor.publish('files', function (file) { 
console.log("publish", file); 
return FilesCollection.find(t{ 
name: file 


} 























发 布 是 基于 
文件 名 的 





你 可 以 在 http://caniuse.com/#feat=filereader 检 查 哪 些 浏览 器 支持 FileReader API。 
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传递 会 话 变量 ， 
if (Meteor.isClient) { 单个 文件 将 被 
Tracker.autorun(function (computation) { 返回 
Meteor.subscribe('files', Session.get ('file')); < 


二 
} 


现在 ,数据库 中 的 文件 可 以 发 送 到 客户 端 ， 是 时 候 来 实现 上 传 过 程 了 。 

4. 使 用 FileReader API 上 传 图 片 到 集合 

利用 HTML5 本 身 的 功能 ， 在 客户 端 上 传 文件 不 需要 任何 Meteor 相 关 的 代码 。 选 择 一 个 文件 
将 触发 上 传 , 文件 的 内 容 将 上 传 到 服务 器 端的 方法 并 被 存储 在 数据 库 中 。 正 如 你 在 下 面 的 代码 清 
单 中 可 以 看 到 的 ， 这 个 代码 看 起 来 有 点 复杂 ， 我 们 一 行 一 行 地 来 看 。 


代码 清单 10-17 使 用 FileReader 上 传 文件 


if (Meteor.isClient) { 
Template.upload.events({ 
'change #file-upload': function (event, template) { 
var file = event.target.files[0]; 
Var name = event.target.files[0] .name; 

















Var reader = new FileReader(); 
reader.onload = function (file) { 
Var result = reader.result; 
Meteor.call('saveFile', name, result); 
3 
reader.readAsDataURL (file); 
} 
地 

} 

该 代码 监听 uploads 模 板 中 有 D 为 file-upload 的 ijnput 字 有 段 的 更 改 。 虽 然 FileReader API 人 允 
许多 个 文件 同时 上 传 ， 但 这 个 代码 只 支持 一 次 上 传 一 个 文件 。 实 际 的 文件 通过 当前 事件 访问 : 
event .target .files[0]。 你 可 以 通过 该 对 象 的 name 属 性 来 访问 文件 名 ， 然 后 文件 名 被 赋 给 
一 个 变量 。 创 建 一 个 FileReader 的 实例 ( reader )。 当 文件 被 成 功 读 取 时 ，onloaqd 事 件 被 触发 ， 
此 时 文件 内 容 发 送 到 服务 器 的 saveFile 方 法 。 该 方法 接受 两 个 参数 : 文件 名 和 一 个 Base64 字 符 
串 ， 其 中 保存 了 文件 的 内 容 (result )。 

为 了 让 FileReader 加 载 文 件 , 使 用 了 reagAsDataURL() 函数 。 这 个 函数 读 取 二 进 制 数据 并 自 
动 将 其 编码 为 Base64 格 式 。 当 这 个 动作 成 功 完 成 时 ，onload () 事件 被 触发 。 

如 果 你 愿意 ,可 以 在 调用 服务 顺 方 法 之 前 进行 额外 的 验证 ， 比 如 ,验证 正在 处 理 的 文件 是 一 
个 图 像 ; 

if (!file.type.match('image.*')) { 

alert('Only image files are allowed'); 


return; 


} 
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相应 的 服务 器 方法 saveFile (代码 清单 10-18 ) 应 该 看 起 来 很 熟悉 ， 同 你 以 前 看 到 的 例子 的 
唯一 区 别 是 puffer 中 拥有 更 多 的 数据 ,并且 是 Base64 编 码 的 。 所 有 的 数据 通过 DDP 发 送 到 方法 ， 
这 次 也 不 例外 。 上 传 完 全 通过 WebSockets 完 成 ， 而 不 是 使 用 传统 的 HTTP。 


代码 清单 10-18 在 集合 中 存储 文件 的 saveFile 方 法 


if (Meteor.isServer) { 
Meteor.methods({ 
'saveFile': function (name, buffer) { 
FilesCollection.insert({ 
name: name, 
base64: puffer 
}) 
} 
3} 
} 


剩 下 要 做 的 就 是 显示 图 像 的 内 容 。 
5. 显示 存储 在 集合 中 的 图 像 
在 这 一 点 上 ， 剩 下 的 代码 很 简单 。 图 像 将 像 任 何其 他 集合 文档 那样 被 返回 : 
if (Meteor.isClient) { 
Template.file.helpers({ 
"Efile fuUnctidn nk 生 
return FilesCollection.findone(); 
} 
} 
} 
前 面 已 经 增加 了 模板 ， 所 以 你 现在 就 可 以 测试 新 的 上 传 功能 
请 记 住 , 这 个 简单 的 解决 方案 不 适合 大 文件 和 高 流量 环境 , 但 它 对 于 实现 快速 和 可 移植 的 上 
传 功能 是 非常 有 用 的 。 
























































10.5 总结 


在 本 章 中 ， 你 了 解 到 以 下 内 容 。 

口 尽管 Node.js 的 设计 是 无 阻塞 的 ,但 在 Meteor 应 用 中 写 阻塞 的 代码 是 可 能 的 。 

口 Meteor 引 入 纤维 使 得 编写 异步 代码 更 加 容易 。 

口 在 服务 器 上 写 异步 代码 时 ， 你 可 能 会 使 用 unblock () 和 wrapAsync。 只 在 少数 情况 下 应 
该 使 用 bingdEnvironment。 

口 通过 http 包 调用 外 部 API 时 应 该 异步 进行 ， 以 避免 阻塞 。 

口 异步 服务 器 函数 可 能 会 通过 回调 函数 返回 错误 到 客户 端 。 

口 处 理 文件 上 传 有 多 种 选项 。 如 果 不 使 用 社区 包 ， 最 简单 的 方法 是 使 用 应 用 的 数据 库 。 










































































走出 陨石 坑 


本 书 的 最 后 两 章 讨论 了 构建 、 调 试 和 部 署 应 用 。 第 11 章 解释 构建 过 程 如 何 工作 ， 并 教 你 
如 何 把 一 个 Web 应 用 变 成 手机 和 平板 应 用 。 在 第 12 章 你 将 了 解 Meteor 应 用 成 功 部 署 的 先决 条 
件 、 简 单 的 负载 测试 和 缩放 选项 。 
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本 章 内 容 

口 自 定 义 Meteor 构 建 过 程 

口 使 用 服务 器 外 过 和 noqe-inspector 进 行 调 试 
口 创建 浏览 器 应 用 

口 创建 移动 应 用 














随 着 智能 手机 的 兴起 ，Web 应 用 可 以 不 再 需要 Web 浏 览 咽 ， 因 为 它们 也 可 以 作为 移动 应 用 。 
如 果 不 提供 移动 平台 的 支持 ，Meteor 将 不 是 一 个 建立 现代 应 用 的 合适 工具 。 能 够 运行 Meteor 应 用 
的 平台 可 以 是 服务 器 、 浏 览 器 ， 甚 至 是 iOS 和 Android 这 样 的 移动 设备 。 
虽然 没有 必要 创建 应 用 的 exe 文 件 或 二 进 制 文 件 ， 但 即使 JavaScript 这 样 的 解释 性 语言 都 需要 
一 些 源码 处 理 才 能 运行 。 创 建 JavaScript 项 目 最 熟悉 的 一 个 步骤 是 缩小 ， 即 将 源 文件 减少 到 最 小 ， 
以 可 读 性 为 代价 将 网 络 流量 降 到 最 小 。 

把 源 代码 转换 成 可 执行 的 应 用 是 构建 工具 的 工作 。Meteor 的 构建 工具 是 Isobuild, 主要 工作 在 
幕后 ， 使 你 专注 于 编码 而 不 是 建立 构建 过 程 。 

在 这 一 章 中 ， 我 们 将 对 Isobuild 的 以 下 两 个 主要 方面 进行 详细 讨论 : 
口 Meteor 的 构建 过 程 如 何 工 作 ; 
口 如 何 建 立 各 种 平台 的 应 用 。 
此 外 ， 本 童 还 介绍 了 调试 技术 ， 它 可 让 你 更 好 地 了 人 解 应 用 在 运行 时 内 部 所 发 生 的 情况 。 
读 完 这 一 章 ， 你 将 能 够 自 定义 工作 流 ， 使 你 的 应 用 在 iOS 和 Android 设 备 上 运行 。 


11.1 Meteor 的 构建 过 程 


每 当 Meteor 项 目 运行 时 , Isobuild 在 幕后 都 很 忙 。 它 需要 组 合 所 有 包含 HTML 和 JavaScript 源 码 
的 文件 ,将 样式 信息 放 在 一 起 ,并 将 这 些 与 项 目 中 所 有 包 的 内 容 进行 智能 地 合并 。 输 出 一 个 可 以 
在 开发 或 生产 系统 上 运行 的 应 用 。 

让 我 们 重新 审视 第 1 章 中 引入 的 图 ， 其 中 显示 了 Meteor 应 用 源码 的 各 个 部 分 ( 参见 图 11-1 )。 
构建 应 用 意味 着 处 理 左 边框 中 的 内 容 ， 使 它们 可 以 运行 在 右边 显示 的 某 个 或 所 有 的 平台 上 。 
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Isobuild 负 责 处 理 这 个 转变 。 它 是 一 个 完整 的 工具 链 ， 用 于 把 源码 转换 成 可 以 在 不 同 平台 上 运行 
的 程序 。 


Isobuild 把 应 用 中 的 各 个 组 件 组 织 起 来 








cordova 相 机 插件 
cordova 电 池 插 件 























Isobuild 服务 器 
图 11-1 Isobuild 处 理 Meteor 应 用 的 各 个 组 件 并 把 它们 转化 为 各 平台 上 的 应 用 


对 一 个 同 构 的 平台 来 说 ， 通 过 包 添 加 的 所 有 功能 ， 在 技术 栈 的 多 个 〈 理想 的 状态 是 所 有 的 ) 
组 件 中 必须 表现 一 样 。 当然 也 有 例外 , 例如 , 在 服务 器 平台 上 访问 手机 的 电话 筹 几乎 是 不 可 能 的 。 
但 大 多 数 其 他 功能 ， 如 从 Web 服 务 中 获取 内 容 ， 必 须 以 完全 相同 的 方式 调用 ， 而 不 管 它们 发 生 在 
哪里 。 你 不 需要 在 浏览 器 中 使 用 jQuery .get () 而 在 服务 器 上 使 用 http .request () ，Meteor 提 
供 了 一 个 抽象 的 API， 使 你 可 在 任何 地 方 使 用 HTTP.get () 达到 相同 的 效果 。Meteor 不 仅仅 在 整 
个 栈 中 使 用 相同 的 语言 ， 它 使 用 了 相同 的 API 使 相同 的 代码 可 以 在 任何 地 方 运行 。 








为 什么 Meteor 有 自己 的 构建 系统 

JavaScript 世 界 里 有 大 量 的 构建 工具 一 npm、jake、bower、grunt 和 gulp。 为 什么 Meteor 
没有 使 用 其 中 的 某 一 个 而 是 使 用 了 Isobuild? 

构建 Meteor 应 用 需要 一 个 对 于 服务 器 端 和 客户 端 代码 都 能 很 好 工作 的 构建 工具 。 大 多 数 工 
具 都 只 专注 于 这 些 环境 中 的 某 一 个 , 所 以 它们 不 适合 一 个 全 栈 的 平台 , 尤其 是 当 它 们 必须 满足 
代码 同 构 性 的 时 候 。 

Meteor 包 不 仅 可 以 使 用 JavaScript、CSS、Spacebars, 也 可 以 使 用 CoffeeScript、Jade 或 LESS。 
这 些 需要 一 个 额外 的 构建 步骤 将 其 内 容 翻 译 成 前 面 的 语言 。 此 外 ，Isopack 可 能 不 仅 包含 代码 ， 
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也 包含 字体 文件 或 图 像 这 样 的 资源 。 这 意味 着 向 客户 端 数据 包 注 入 资源 成 了 必要 的 步骤 。 

软件 包 管 理 器 的 另 一 个 缺点 是 选择 的 悖 论 。 许 多 软件 包 提 供 了 类 似 的 功能 ,很 难 分 辩 哪 一 
个 是 最 好 的 (并且 仍 然 在 维护 中 ) 选择 。Meteor 开 发 小 组 通过 使 用 包 的 两 级 命名 空间 来 解决 这 
个 问题 。 像 curator:packagename 这 种 风格 的 包 , 即 以 管理 者 为 前 级 的 包 , 被 认为 是 一 个 社区 包 。 
一 旦 这 些 包 被 广泛 测试 和 普遍 接受 ， 它 们 就 可 扔 掉 管 理 者 前 组 ,被 认为 是 相对 安全 的 ， 从 而 使 
开发 人 员 更 容易 从 一 系列 的 包 中 挑选 出 最 可 靠 的 包 。 

由 于 现 有 的 解决 方案 没有 一 个 能 够 满足 全 栈 构建 和 包 管 理 的 所 有 要 求 ， 所 以 Meteor 0.9 引 
入 了 Isobuild 系 统 。 


我 们 在 前 面 章 节 写 的 所 有 代码 和 添加 的 所 有 资源 〈 还 记得 我 们 在 第 2 章 用 于 显示 冰箱 的 图 像 
吗 ? ) 都 被 认为 是 业务 逻辑 。 对 于 一 些 Meteor 的 功能 ,我 们 使 用 ( Isopack ) 包 ， 如 果 需 要 的 话 也 
使 用 npm 包 。 所 有 Meteor 应 用 的 默认 目标 平台 是 服务 器 和 浏览 器 , 它们 都 不 支持 Cordova 包 。 当 你 
要 为 移动 平台 创建 应 用 ， 需 要 访问 移动 设备 的 硬件 ， 比 如 相机 或 手机 通讯 录 中 的 联系 人 时 ， 就 需 
要 Cordova 包 。 因 此 ， 我 们 将 在 本 章 的 后 面 看 看 Apache Cordova/PhoneGap 的 更 多 细节 。 



































说 明 Apache Cordova 是 一 个 开源 项 目 ， 它 将 基于 HTMLS 的 应 用 变 成 移动 应 用 ， 并 且 提 供 了 
JavaScript API 来 访问 设备 的 某 些 功能 , 即 那些 对 于 本 地 应 用 可 用 但 不 能 从 Web 浏 览 器 中 访 
问 的 功能 。Adobe PhoneGap 是 这 个 项 目的 一 个 分 支 ， 提 供 了 更 多 的 需要 付费 的 功能 。 在 
本 书 的 上 下 文中 以 及 使 用 谷歌 搜索 时 ， 这 两 个 名 字 可 以 交替 使 用 。 


11.1.1 构建 阶段 


每 次 使 用 meteor run 命 令 运行 一 个 Meteor 应 用 时 ， 构 建 过 程 都 将 被 触发 。Meteor 服 务 器 运 
行 时 , 应 用 代码 的 任何 更 改 都 将 触发 应 用 代码 的 重新 构建 。 直 到 现在 我 们 都 还 没有 仔细 观察 在 构 
建 过 程 中 我 们 的 代码 上 发 生 了 什么 事情 ， 是 时 候 来 看 一 看 了 。 

Meteor 的 构建 过 程 有 以 下 几 个 阶段 。 

(1) 读 取 项 目 元 数据 。 

(2) 初始 化 目录 。 

(3) 解决 约束 。 

(4) 下 载 缺失 的 包 。 

(5) 构建 本 地 包 。 

(6) 保存 更 改 的 元 数据 。 

让 我 们 逐一 看 看 这 些 阶 段 。 

阶段 1: 读 取 项 目 元 数据 

在 构建 进程 执行 任何 操作 之 前 ， 它 会 读 取 当 前 项 目的 配置 信息 。 每 个 Meteor 项 目 都 有 一 些 元 
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数据 存储 在 .meteor 目 录 中 。 其 中 有 四 个 文件 保存 了 构建 过 程 的 所 有 相关 信息 。 你 可 以 手动 编辑 它 




















们 ， 但 修改 它们 的 标准 方法 是 用 Meteor 的 CLI 工 具 ( 参见 表 11-1 )。 
表 11-1 用 于 存储 项 目 元 数据 的 文件 及 其 相应 的 CLI 命 令 





文 件 名 修改 命令 包含 有 关 …… 的 信息 
.meteorpackages meteor list 这 个 项 目 所 使 用 的 Meteor 包 ， 每 行 一 个 


meteor add 
meteor remove 
.meteor/platforms meteor list-platforms 项 目 构 建 的 目标 平台 
meteor add-platform 
meteor remove-platform 


.meteor/release meteor create 将 用 于 此 项 目的 Meteor 版 本 
meteor update 

















.meteor/versions meteor update 项 目 需要 的 包 和 Isobuild 版 本 求解 器 所 确定 的 包 的 版 本 
每 个 项 目 都 有 一 个 Meteor 框 架 "的 基础 版 本 存储 在 发 布 (release ) 文件 中 。 当 你 第 一 次 创建 
一 个 新 项 目 ， 每 次 在 项 目的 根 文件 夹 中 执行 upaate 命 令 时 ， 这 个 版 本 号 会 被 更 新 。 这 是 版 本 
求解 器 工作 的 起 点 ， 用 以 确定 哪些 版 本 的 包 可 以 一 起 工作 (请 参阅 第 9 章 有 关 版 本 求解 器 的 详 








细 信 息 )。 








每 当 你 使 用 meteor 命 令 添加 或 删除 一 个 包 时 ， 它 会 触发 包 (packages ) 文件 的 编辑 。 默 认 情 
况 下 ， 新 建 的 项 目 从 meteor-platform、autopublish 和 insecure 三 个 包 开 始 。 包 可 以 依赖 
于 其 他 的 包 。 例如，meteor-platform 包 由 多 个 其 他 包 组 成 ， 但 它们 不 在 包 文 件 中 列 出 。 它 们 





由 Isobuild 进 行 隐 式 管理 。 





添加 一 个 新 包 将 在 文件 的 最 后 添加 一 行 ， 所 以 该 文件 的 内 容 是 按时 间 而 不 是 字母 顺序 排 


列 的 。 


在 版 本 (versions ) 文件 中 ，Meteor 跟 踪 建 立 当 前 项 目 所 需 的 所 有 包 ， 无 论 它 们 是 显 式 地 添 
加 还 是 作为 一 个 依赖 添加 。 因 此 ， 如 tracker 这 样 的 包 没 有 在 包 文 件 中 列 出 , 但 会 在 版 本 文件 中 





列 出 。 如 果 你 想 把 项 目 中 使 用 的 所 有 软件 包 更 新 到 最 新 版 本 ， 可 使 用 neteor upaate。 








你 不 应 





该 手动 编辑 此 文件 ， 它 是 由 Isobuild 维 护 的 ”。 版 本 文件 中 的 包 是 按 字母 顺序 排列 的 ， 它 们 是 第 三 











阶段 中 处 理 包 文件 的 结果 。 


说 明 如 果 只 需要 将 包 更 新 到 它们 的 最 新 版 本 ， 而 不 需要 更 新 Meteor 框 架 的 版 本 ， 可 在 update 


命令 中 添加 --packages-only 选 项 。 





当 你 发 出 一 个 meteor run 命 令 时 ,发 生 的 第 一 件 事 就 是 读 取 这 四 个 文件 。 
阶段 2: 初始 化 目录 




















在 构建 上 下 文中 ， 目 录 (catalog ) 基本 上 就 是 版 本 文件 。 其 中 列 出 了 构建 项 目 所 需 的 所 有 




















Qa 在 这 里 我 们 将 使 用 框架 ( framework ) 而 不 是 平台 ( platform )， 以 避免 目标 平台 与 Meteo! 平 台 的 混淆 。 
@ 当 你 使 用 meteor adg 添 加 一 个 有 特定 版 本 约束 的 包 时 ， 版 本 文件 的 内 容 将 被 更 新 。 因 为 它 不 影响 构 到 
以 我 们 不 会 详细 讨论 这 个 案例 的 细节 。 












































EE 过 程 ， 所 
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Isopack。 当 一 个 新 包 从 包 文 件 中 添加 或 删除 ，meteor run 被 调用 时 ， 版 本 文件 中 也 需要 添加 或 
删除 适当 的 包 。 如 果 一 个 包 引 入 了 额外 的 依赖 关系 ， 那么 被 依赖 的 包 也 需要 被 引入 ,这 发 生 在 下 
一 阶段 。 

阶段 3: 解决 约束 

解决 约束 阶段 的 目的 是 确定 包 和 版 本 的 依赖 关系 。 所 有 本 地 可 用 的 包 都 存储 在 Meteor 的 安装 
文件 夹 中 ， 而 不 是 当前 项 目 文件 夹 中 。 要 解决 约束 ， 每 个 包 的 配置 信息 都 会 被 读 取 。 如 果 一 个 包 
的 配置 中 引用 了 另 一 个 包 或 一 个 本 地 不 存在 的 版 本 , 那么 额外 的 包 会 被 标记 为 必要 的 , 并 在 下 一 
阶段 获取 。 

阶段 4: 下 载 缺 失 的 包 

如 果 包 还 不 在 磁盘 上 ，Meteor 会 试图 从 网 上 自动 下 载 它们 。 所 有 的 包 都 将 存储 在 Meteor 安 装 
文件 夹 中 , 而 不 是 当前 项 目 文件 夹 中 。 这 样 , 同一 台 机 器 上 的 所 有 Meteor 项 目 都 可 以 共享 这 些 包 。 

最 终 ， 所 需 的 全 部 Isopack 都 可 用 了 ， 构 建 过 程 就 可 以 开始 了 。 

阶段 5: 构建 本 地 包 

在 构建 系统 上 ， 当 所 有 包 都 可 用 时 ， 系 统 会 为 当前 项 目 构建 它们 。 代 码 和 资源 (字体 、 图 像 
等 ) 将 被 添加 到 项 目 中 的 .meteor/local 文 件 夹 。 男 外 ， 它 会 为 每 个 JavaScript 文 件 创建 源码 映射 图 。 
源码 映射 图 可 让 你 在 浏览 器 中 查看 源 文件 ， 即 使 文件 是 缩小 过 的 。 

阶段 6: 保存 更 改 的 元 数据 

一 旦 所 有 的 构建 步 又 都 已 执行 ， 当 前 状态 将 被 保存 在 版 本 和 包 文 件 中 。 

更 新 和 重复 : 观察 变化 
虽然 技术 上 说 这 不 是 一 个 构建 阶段 ， 但 run 命 令 将 继续 监控 应 用 文件 的 任何 更 改 ， 在 需要 的 
时 候 再 执行 构建 过 程 。Meteor 用 不 同 的 方式 处 理 客户 端 和 服务 器 端的 修改 。 客 户 端的 修改 在 处 理 
后 使 用 热 码 推送 直接 发 送 到 浏览 器 。 所 有 服务 器 端的 变化 会 导致 应 用 的 重新 加 载 。 请 注意 ,这 也 
将 执行 服务 器 上 下 文中 的 所 有 Meteor .startup () 函数 。 

Meteor 采 用 先进 的 方法 来 检测 文件 的 修改 , 它 类 似 于 使 用 MongoDB 的 操作 日 志 监 控 数 据 库 变 
化 的 方法 。 在 苹果 的 O0SX 上 , 用 到 了 一 个 名 为 kaueue 的 内 核 扩 展 ; 在 Linux 上 ，inotify 会 把 发 
生 的 所 有 文件 操作 告诉 Meteor。 在 Windows 上 没有 类 似 的 机 制 可 用 。 

当 Meteor 使 用 kaqueue 或 inotify 时 ， 每 隔 5000 毫 秒 就 检查 一 次 是 否 有 变化 发 生 ， 和 500 毫 秒 
的 缺 省 设置 比 起 来 , 它 对 CPU 和 磁盘 操作 来 说 更 容易 。 通 过 NFS 挂 载 或 通过 虚拟 机 ( 比如 Vagrant" ) 
共享 的 远程 文件 系统 ， 可 能 没有 这 个 内 核 扩展 。 如 果 Meteor 进 程 需要 间隔 $ 秒 才能 处 理 文件 系统 
中 的 任何 变化 , 这 个 监控 可 能 不 能 正常 工作 。 在 这 些 罕见 的 情况 下 , 你 可 以 使 用 两 个 环境 变量 来 
定义 轮 询 行为 ( 即 定期 检查 更 改 ),。 在 开启 meteor 进 程 的 同一 个 终端 会 话 中 ,发 出 以 下 命令 来 强 
制 轮 询 ， 无 论 kqueue 或 inotify 是 否 存 在 ， 并 设置 轮 询 间隔 为 10 秒 : 















































































































































$ export METEOR_WATCH_FORCE_POLLING=t 
$ export METEOR_WATCH_POLLING_INTERVAL MS=10000 




















关于 如 何 使 用 Vagrant 的 更 多 细节 可 参考 附录 A。 
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说 明 环境 变量 METEOR_WATCH_FORCE_POLLING 期 望 值 为 上 ， 这 会 把 它 设 置 为 true， 否 则 其 默 
认 值 为 false。 轮 询 间 隔 以 毫秒 为 单位 ， 不 设置 时 ， 它 的 默认 值 为 $000 毫 秒 ( 如 果 强 制 轮 
询 间隔 为 500 毫 秒 )。 














11.1.2 ”使 用 --production 选项 运行 


如 果 在 项 目 中 使 用 了 一 个 复杂 的 文件 结构 ， 你 可 以 看 到 使 用 meteor run 几 乎 不 会 改变 文件 
的 数量 或 结构 。 它 们 只 会 被 复制 到 .meteor/local/build 目 录 。 

这 种 行为 便于 在 本 地 系统 上 进行 开发 , 因为 简单 的 复制 操作 不 会 为 每 个 文件 的 更 改 增 加 大 量 
的 开销 。 然而 在 生产 环境 中 , 需要 提供 的 文件 越 少 就 越 利于 初始 页 的 加 载 。 因 此 , 在 Web 环 境 中 ， 
同一 类 型 的 所 有 文件 通常 会 被 合并 ， 这 样 就 只 有 三 个 文件 必须 被 发 送 到 浏览 器 。 
口 一 个 JavaScript 文 件 
D 一 个 CSS 文 件 
口 一 个 HTML 文 件 
而 且 ， 这 些 文件 的 内 容 会 被 缩小 ， 从 而 进一步 减少 数据 的 传输 时 间 。 不 幸 的 是 ,合并 和 压缩 
源 文件 可 能 导致 一 些 意 想不到 的 后 果 ， 如 混乱 的 风格 或 骨 溃 的 应 用 。 为 了 避免 意外 , 在 部 署 所 谓 
已 经 完成 的 代码 时 ， 可 使 用 --prodquction 参 数 运行 一 个 本 地 项 目 : 

$ meteor run --production 
使 用 这 个 参数 将 触发 额外 的 构建 步骤 。 所 有 发 送 到 客户 端的 代码 将 会 按照 类 型 (JS 、CSS、 
HTML ) 进行 合并 ， 并 被 随机 赋予 一 个 41 字 符 长 的 名 字 。 但 服务 器 端 代码 不 会 被 合并 ， 因 为 这 些 
文件 不 会 被 发 送 到 网 络 上 ,合并 它们 不 会 产生 明显 的 性 能 优势 。 

额外 的 构建 步 又 将 拖 慢 服务 器 重启 和 热 码 推送 的 速度 ,请 在 测试 时 使 用 --production, 不 
要 在 开发 过 程 中 使 用 它 。 
























































仅 用 于 调试 的 包 

有 些 包 添 加 的 功能 仅 在 开发 环境 中 有 用 。 如 果 它 们 暴露 了 用 于 访问 内 部 数据 或 执行 测试 的 
接口 ， 把 它们 部 署 到 生产 环境 甚至 会 很 危险 。 为 了 避免 部 署 这 些 包 ， 可 以 为 这 些 包 设置 一 个 
debugOnly 标 志 。 这 一 标志 建议 Meteor 在 使 用 --production 选 项 运行 时 , 不 要 在 构建 过 程 中 
包含 这 些 包 。 


11.1.3 ”加 载 顺 序 

因为 可 以 自由 创建 文件 和 文件 夹 、 使 用 任何 目录 结构 ， 所 以 了 解 Meteor 加 载 过 程 中 的 优先 级 
是 很 重要 的 。 特 别 是 使 用 - -broduction 参 数 进行 客户 端 文件 合并 时 ,错误 的 加 载 顺 序 可 能 会 导 
致 错误 和 应 用 崩溃 。 
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Meteor 的 加 载 顺 序 基于 命名 约定 和 文件 夹 的 层次 结构 。 此 加 载 顺 序 只 适用 于 应 用 的 业务 逻 
辑 。 包 的 加 载 顺 序 是 在 包 定 义 中 手动 定义 的 ( 更 多 细节 请 参阅 第 9 章 )。 

作为 一 个 经 验 法 则 , 子 目录 中 的 文件 在 父 目 录 文 件 之 前 被 Meteor 加 载 。 一 个 文件 在 项 目 目录 
中 的 深度 越 深 , 它 将 越 早 被 加 载 。 因 此 , 根 目录 中 的 文件 将 被 最 后 加 载 。 在 相同 的 层次 级 别 或 同 
一 个 目录 中 ， 文件 按 文件 名 的 字母 顺序 加 载 。 

这 个 通用 规则 有 一 些 例外 。 

D lib/ 目 录 下 的 所 有 文件 夹 在 所 有 其 他 文件 夹 内 容 之 前 被 加 载 。 如 果 有 多 个 li 文件 夹 存在 ， 
它们 按 层次 ( 深度 优先 以 及 字母 顺序 加 载 。. 这 样 ,clienVlib/filel.js 在 client/scripts/views/file2. 
js 之 前 加 载 ， 尽 管 通用 规则 认为 fie2 在 层次 结构 中 有 和 较 深 的 位 置 ， 应 该 首先 加 载 。 

口 client/compatibility/ 目 录 是 保留 目录 , 用 于 那些 依赖 于 以 var 在 顶层 声明 的 变量 的 库 , 这 些 
变量 将 输出 为 全 局 变量 。 这 个 目录 中 的 文件 被 执行 时 不 会 被 包 在 一 个 新 的 变量 范围 内 。 
这 些 文件 在 其 他 客户 端 JavaScript 文 件 之 前 执行 ， 但 在 lib/ 内 容 之 后 执行 。 

口 所 有 名 为 main.* 的 文件 在 所 有 其 他 文件 之 后 被 加 载 。client/lib/validations.js 在 client/lib/ 
main.helper.js 之 前 加 载 。 
口 所 有 private/ test/ 和 public/ 目 录 下 的 任何 内 容 都 不 会 被 自动 加 载 , 也 不 会 被 构建 过 程 处 理 。 

取决 于 Meteor 在 服务 器 还 是 客户 端 上 下 文中 运行 ， 有 一 些 文件 可 能 根本 不 会 加 载 。Meteor 忽 

略 某 些 文件 夹 中 的 内 容 ， 以 防止 将 所 有 代码 发 送 到 浏览 器 ， 即 使 它 从 来 不 会 运行 到 那里 。 表 11-2 
列 出 了 服务 器 上 被 忽略 的 或 不 会 发 送 到 客户 端的 所 有 文件 夹 。 


表 11-2 在 服务 器 和 客户 端 上 下 文中 被 忽略 的 目录 










































































在 服务 器 上 下 文中 排除 在 客户 端 上 下 文中 排除 
client/ server/ 
public/ public/ 
private/ private/ 


tests/ tests/ 


图 11-2 和 图 11-3 显 示 了 实际 的 加 载 顺 序 。 每 个 文件 在 加 载 后 控制 台 都 会 打印 它 的 名 字 。 正 如 
你 看 到 的 ， 服 务 器 上 只 有 两 个 文件 被 加 载 ( common.js 和 server.js )， 而 客户 端 共 加 载 了 八 个 
JavaScript 文 件 。 同 一 层 的 所 有 目录 将 按 字母 顺序 进行 加 载 。 所 有 的 JavaScript 代 码 加 载 都 将 特殊 
目录 private 、public 和 test 排 除 在 外 。 
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服务 器 上 的 加 载 顺序 
eoe 闻 loadOrder 


MacBook: LoadOrder stephan$ meteor 
应 用 程 [[[[[ ~/Desktop/toadorder ]]]]] 
=> Started proxy. 
=> Started MongoDB. 
=> Started your app. 


=> App running at: http://localhost:3000/ 
common/common.js loaded 
server/server.js loaded 





1. 按 字 母 顺 序 排序 


2. private、public 和 test 目 录 被 忽略 















































图 11-2 在 服务 器 上 通过 控制 台 消息 观察 JavaScript 文 件 的 加 载 顺 序 
1. 所 有 1lib/ 目 录 下 的 文件 首先 加 载 
应 用 程序 资源 客户 端 加 载 顺 序 
y | ns i 富 <topframe> 
EPE Library,js Loaded 
9 fagllelibjs Validations,js Loaded 
"加 Ib edit,js loaded 
所 libraryjs fragile-lib,js loaded 
所 main.helperjs client.js loaded 
hs 包 validationsjs common,js loaded 
多 mainjs main,hetper,js loaded 
v MM views > 
志 olient.js 
v MM edit 
edit.html 
得 editjs 3. 同一 层 的 文件 按 字 母 
®) main html 顺序 加 载 : compatibility 
9 style.css 在 views 前 面 
Y 国 common 
克 commonjs 2. 深层 目录 下 的 文件 优先 被 加 载 





4. 名 为 main.* 的 文件 最 后 
加 载 ， 不 管 它们 在 什么 地 方 








图 


11-3 在 客户 端 通过 控制 台 

















NN 














消息 查看 JavaScript 文 件 的 加 载 顺序 


客户 端 使 用 了 更 复杂 的 文件 结构 ,不 管 lb 目录 在 什么 位 置 ,其 下 的 所 有 内 容 都 将 首先 被 加 载 ， 
这 就 是 为 什么 lib 下 的 文件 在 所 有 其 他 文件 之 前 被 发 送 。 然 后 所 有 文件 按 目 录 层 次 由 深 到 浅 进行 加 
载 ; 同一 层 上 的 目录 和 文件 按 字母 顺序 加 载 。 这 意味 着 client/views/edityeditjs 比 client/views/clients.js 
优先 加 载 。 所 有 名 为 main.* 的 文件 都 被 移动 到 加 载 序 列 的 最 后 。 所 以 即使 main.helperjs 放 在 lib/ 中 ， 
它 也 会 在 所 有 其 他 文件 之 后 加 载 。 所 有 这 些 规则 也 同样 适用 于 服务 顺 环 境 。 
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11.1.4 ”通过 包 添 加 构建 阶段 


扩展 构建 过 程 最 简单 的 方法 是 在 项 目 中 添加 一 个 核心 包 以 增加 语言 支持 。 
以 下 的 核心 包 可 用 于 在 构建 过 程 中 添加 新 的 阶段 。 
D coffeescript 包 增加 了 转换 (transpiling”) *.coffee 文 件 到 JS 的 功能 。 
口 less 或 stylus 包 增加 了 转换 *.less 或 *.sty 文 件 到 CSS 文 件 的 功能 。 
对 于 额外 的 语言 支持 ， 也 有 各 种 社区 包 可 用 。 可 以 检查 一 下 官方 的 包 存储 库 ， 看 看 你 想 要 使 
用 的 语言 是 否 已 经 可 用 。 
作为 第 三 个 选项 ， 你 可 以 选择 开发 自己 的 包 以 增强 构建 过 程 。 
1. CoffeeScript 
很 多 JavaScript 开 发 者 喜欢 使 用 CoffeeScript 代 替 纯 的 JavaScript。CoffeeScript 使 用 了 不 同 的 语 
法 ， 它 使 用 更 少 的 括号 和 分 号 ， 需 要 用 程序 转换 为 普通 的 JavaScript 才 可 以 在 浏览 器 内 和 Node.js 
中 执行 。 
要 在 Meteor 项 目 中 使 用 CoffeeScript， 简 单 地 添加 coffeescript 包 就 可 以 : 


















































$ meteor aqdq coffeescript 


一 旦 该 包 在 Meteor 项 目 中 可 用 ， 所 有 以 .coffee 为 扩展 名 的 文件 就 可 以 使 用 了 ， 每 当 它 们 被 修 
改 时 就 会 被 自动 转换 ( 翻译 ) 成 JavaScript。 这 样 ，JavaScript 文 件 就 可 以 和 CoffeeScript 写 的 代码 
一 起 使 用 ， 比 如 在 添加 一 个 外 部 库 到 lib/ 文 件 夹 的 时 候 。 

事实 上 ，Meteor 除 了 支持 另 一 种 文件 扩展 名 并 增加 了 一 个 翻译 阶段 以 外 ,其 余 的 构建 过 程 完 
全 保持 不 变 ， 包 括 文件 的 加 载 顺 序 也 不 变 。 

2.LESS 或 Stylus 

Meteor 本 身 就 支持 使 用 CSS 静 态 样 式 文件 。 如 果 添 加 了 相应 的 包 , 动态 样式 语言 LESS 和 Stylus 
也 可 以 使 用 。 这 些 语言 被 称 为 预 处 理 器 ， 它 们 使 用 变量 和 混入 mixin ) 来 增强 样式 。 混 入 允许 
你 使 用 很 容易 重用 的 样式 片段 ， 从 而 在 整体 上 缩短 必须 要 写 的 代码 。 结 合 变 量 的 使 用 , 它 使 得 定 
制 设 计 更 加 容易 ， 这 就 是 很 多 开发 者 比 起 普通 CSS 更 喜欢 动态 预 处 理 器 的 原因 。 

LESS 和 Stylus 需 要 转换 成 纯 CSS， 这 样 浏览 器 才能 够 解释 它们 。 让 我 们 开始 通过 CLI 来 添加 
其 中 的 一 个 包 : 





















































$ meteor add less 
$ meteor aqq stylus 


添加 其 中 一 个 包 的 结果 是 , 以 .less 或 .sty 为 扩展 名 的 文件 将 会 被 Meteor 识 别 并 处 理 。 对 构建 过 
程 来 说 ， 这 两 个 预 处 理 需 的 行为 几乎 完全 一 样 。 
Meteor 将 所 有 的 样式 文件 合并 成 一 个 ,按照 上 述 的 顺序 进行 加 载 。 为 了 获得 对 加 载 顺 序 的 更 























中 术语 transpiling 用 于 描述 源码 到 源码 的 编译 。 一 般 情况 下 ， 编 译 一 个 文件 将 导致 抽象 水 平 的 降低 ， 例 如 ， 当 C 代 码 
转换 成 汇编 时 。 而 transpiling 时 ， 其 抽象 水 平 保持 不 变 ， 比 如 从 CoffeeScript 到 JavaScript。 
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多 控制 ， 你 可 以 从 一 个 样式 文件 导入 特有 的 文件 。 如 果 一 个 文件 的 扩展 名 是 *.import.less 
或 .import sty，Meteor 不 会 在 构建 过 程 中 处 理 它 ， 除 非 它们 在 一 个 样式 文件 中 被 直接 引用 。 

在 实践 中 ， 最 终 你 会 有 一 个 styles.less 文 件 ， 它 可 能 看 起 来 类 似 于 代码 清单 11-1。 显 然 ， 引 用 
的 文件 必须 要 存在 才能 导入 。 


代码 清单 11-1 使 用 LESS 预 处 理 器 的 样式 文件 示例 


@bg-color: #ff£f9900; < 











.rounded top_ mixin { 
-webkit-border-top-left-radius: 5px; 
-webkit-border-top-right-radius: 5px; 
-moz-border-radius-topleft: Spx; 
-mozZz-border-radius-topright: 5S5px; 
border-top-left-radius: 5px; 
border-top-right-radius: 5px; 





声明 一 个 混 


} 


一 个 变量 

tab { 使 用 作 莹 星 
background: @bg-color; 一 八 泪 
.rounded_ top_mixin; 4 | 人 


导入 额外 的 


@import "variables.import.less"; 4 -less 文 件 


11.1.5 ”添加 自 定义 构建 阶段 


在 版 本 1.1 中 ， 扩 展 Meteor 构 建 阶段 的 可 能 方法 仅 限于 监视 特定 扩展 名 文件 的 更 改 。 对 文件 
的 修改 可 能 会 触发 监控 程序 中 为 特定 文件 扩展 名 配置 的 关联 动作 ， 例 如 将 一 种 语言 转换 到 另 一 
种 语言 。 

基本 上 ， 添 加 一 个 自 定义 构建 阶段 需要 使 用 一 个 包 。 可 在 阶段 5( 构建 本 地 包 ) 中 添加 构建 
步 又。package.js 文 件 中 的 Package.registerBuildqPlugin() 用 于 说 明 一 个 包 扩 展 了 构建 过 
程 。 代 码 清单 11-2 显 示 了 所 使 用 的 代码 ， 其 中 以 coffeescript 包 为 例 。 
DO name 是 构建 阶段 的 标识 。 一 个 包 可 能 包含 多 个 构建 插件 ， 只 要 有 唯一 的 名 称 就 可 以 。 
口 use 指 出 了 这 一 构建 阶段 可 能 需要 依赖 的 其 他 Isopack 包 ， 为 一 个 字符 串 或 字符 串 数组 。 
口 sources 包 含 一 个 字符 串 数组 ， 定 义 哪些 文件 是 该 插件 的 一 部 分 。 
D npmDependencies 是 一 个 对 象 ， 其 中 包含 该 插件 可 能 依赖 的 npm 包 的 名 称 和 版 本 。 

如 果 你 需要 自己 编写 构建 插件 ， 比 如 说 将 TypeScript( JavaScript 的 另 一 种 速记 符号 ) 转换 为 
纯 JavaScript， 你 需要 将 cof fee-script npm 的 依赖 性 修改 为 Ls-compiler 模 块 。 此 外 ,你 还 需 
要 相应 地 调整 名 称 和 源 文件 。 
























































代码 清单 11-2 ”在 package.json 中 注册 一 个 支持 CoffeeScript 的 构建 插件 


Package.registerBuildPlugin(t{ 
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name: "compileCoffeescript", 


USS ||] 

sources: [ 只 有 一 个 源 文件 
'plugin/compile-coffeescript.js' 用 于 此 插件 

], 


npmDependencies: {"coffee-script": "1.7.1", "source-map": "0.1.32"} < 


运行 此 插件 需要 两 个 npm 模 块 





在 构建 插件 的 源 文 件 中 , 可 以 使 用 Plugin.registerSourceHandler () 来 定义 特定 扩展 名 
文件 被 修改 后 要 执行 的 动作 。 如 果 该 插件 应 该 监视 扩展 名 为 .ts 的 文件 ， 那么 它 必 须 被 指定 为 一 个 
源 文件 处 理 程序 。 代 码 清单 11-3 列 出 了 构建 插件 的 基本 框架 。 使 用 compilestep 可 以 对 当前 处 理 
的 文件 进行 读 写 ”。 


代码 清单 11-3 ”在 构建 过 程 中 将 TypeScript 转 换 成 JavaScript 的 框架 代码 


所 需 的 npm 模 块 必须 





//file: plugin/compile-typescript.js 


var typescript = Npm.require('ts-compile'); < 通过 npm.require 包 含 
使 用 文件 扩展 名 
Plugin.registerSourceHandler('ts', handler); < 时 没有 前 面 的 点 


compileStep 可 以 让 处 理 
Var handler = function (compileStep) { < | 程序 访问 当前 文件 
var fileContents = compileStep.read() .toString('utf8'); 
// transpiling logic, result stored inside jsCode 





compileStep.addJavaScript({ < 一 
path: outputPath， addJavaScript 将 构建 步骤 中 生 
sourcePath: compileSstep.inputPath， 成 的 结果 写 入 一 个 JavaScript 
data: jsCode 文件 


3 


说 明 截至 1.1 版 本 ， 有 一 个 对 源 文 件 处 理 程序 的 限制 ， 就 是 对 于 每 个 文件 扩展 名 只 能 使 用 一 个 
构建 插件 。 比 如 说 ， 不 能 有 多 个 插件 为 JavaScript 文 件 添 加 构建 步骤 。 


如 果 你 在 一 个 项 目 中 添加 一 个 包 ， 用 于 将 TypeScript 或 CoffeeScript 转 换 为 JavaScript，buila 
和 zun 过 程 看 起 来 是 像 下 面 这 样 的 。 

(1) Isobuild 确 定 哪 些 文件 发 生 了 变化 。 

(2) 它 查 看 文件 扩展 名 并 检查 是 否 有 compilestep 与 它 联系 在 一 起 。 每 个 文件 扩展 名 可 能 只 
有 一 个 步骤 。 



































使 用 compilestep 的 官方 文档 可 参考 https:/github.com/meteormeteor/wiki/compilestep-api-for-build-plugin source- 
handlers。 
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(3) 如 果 发 现 了 相关 的 compilestep，Isobuild 按 照 构建 插件 的 定义 执行 它 并 保存 输出 。 
(4) 如 果 使 用 pui16 命 令 或 使 用 --production 参 数 运行 Meteor, 在 插件 的 所 有 构建 步骤 完成 
以 后 ， 合 并 和 缩小 步 双 将 独立 运行 。 


11.2 访问 正在 运行 的 应 用 


在 前 面 的 章节 中 , 你 使 用 浏览 器 控制 台 发 送 命令 到 正在 运行 的 应 用 ,比如 检查 一 个 Session 
变量 的 值 。 在 这 一 他 中 , 我 们 将 探索 一 些 可 能 的 方法 来 访问 正在 运行 的 应 用 的 服务 器 端 ， 以 及 怎 
样 获得 更 好 的 调试 能 


11.2.1 使 用 交互 式 服务 器 外 壳 


在 终端 会 话 中 发 出 meteor run 命令 时 ， 你 可 以 在 同一 终端 窗口 中 看 到 所 有 的 服务 器 输出 。 
在 服务 器 端 发 生 的 所 有 控制 台 日 志 记 录 将 会 被 显示 ， 但 它 不 允许 你 发 送 任何 命令 。 每 当 你 需要 检 
查 变量 的 当前 状态 时 , 可 以 在 JavaScript 文 件 中 添加 一 个 console.1og() ,这 将 触发 服务 器 的 重启 。 

对 于 本 地 运行 的 应 用 ，Meteor CLI 工 具 可 以 打开 一 个 交互 式 会 话 外 壳 ， 在 那里 你 可 以 发 送 命 
令 到 服务 器 ， 就 像 在 浏览 器 控制 台中 一 样 。 

1. 调用 交互 式 外 壳 

打开 一 个 终端 会 话 ， 进 入 到 Meteor 项 目的 文件 来。 使 用 以 下 的 命令 启动 Meteor 服 务 : 

$ meteor run 

你 现在 可 以 看 到 项 目 启动 时 的 所 有 服务 器 消息 开始 在 终端 滚动 了 。 打 开 第 二 个 终端 会 话 , 进 
人 到 同一 个 项 目 文件 夹 。 现 在 发 出 以 下 命令 : 

$ meteor shell 

这 个 命令 将 打开 一 个 交互 的 外 壳 ， 如 图 11-4 所 示 。 


@@e@ [load-order 
node | node [二 


MacBook:~ stephan$ cd /Users/stephan/code/github/meteorinaction/ 
ch11-isobuild/load-order 
MacBook: load-order Stephans meteor shell 





























Welcome to the server-side interactive shell! 

Tab completion is enabled for global variables. 

Type .reload to restart the server and the shell. 

Type .exit to disconnect from the server and leave the shell. 
Type .help for additional help. 


> 目 





图 11-4 使 用 meteoz 命 令 调用 交互 式 服务 器 外 壳 





2. 使 用 交互 式 外 过 
所 有 的 外 壳 命 令 都 以 一 个 点 开始 。 它 们 可 以 用 来 执行 能 够 放 在 文件 中 的 任何 代码 。 例如, 在 
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开发 过 程 中 ,你 可 以 查询 外 部 API、 调 用 辅助 函数 或 使 用 col1lection.remove() 从 数据 库 中 轻 
松 删 除 内 容 。 这 样 ， 你 也 可 以 使 用 Meteor 语 法 而 不 是 略 有 不 同 MongoDB 语 法 ， 也 不 需要 使 用 
RoboMongo 或 meteor mongo 来 进行 额外 的 MongoDB 连 接 。 

在 外 壳 中 ， 可 使 用 Tab 键 对 所 有 Meteor 全 局 变量 或 函数 进行 自动 补 全 。 你 也 可 以 使 用 上 下 第 
头 键 来 访问 所 有 命令 的 历史 记录 。 外 壳 的 历史 记录 保存 在 项 目 文件 夹 下 的 .meteorvlocal/ 
shell-history 文 件 中 。 使 用 .save 和 .1oad 命 令 ， 可 以 存储 一 个 可 供 重用 的 命令 序列 。 此 时 ， 当 前 
会 话 中 的 所 有 命令 都 将 被 保存 。 这 对 于 保存 诸如 填充 固定 装置 或 将 应 用 状态 重 置 到 某 一 点 的 情况 
来 说 ， 可 能 是 有 用 的 。 保 存 和 加 载 命 令 序列 需要 一 个 唯一 的 名 称 。 要 把 一 个 命令 序列 保存 为 
bootstrap， 可 以 使 用 以 下 的 命令 : 

> PostsCollection.insert ({title: 'first test article'}) 

'i4xZb8WM8Lr63KWwA4' 

> PostsCollection.insert ({title: 'second test article'}) 


"PVRKekuDuBn6WxX5KY 
> .save bootstrap 


当 你 想 重 新 执行 这 些 命令 时 ， 可 以 在 外 过 中 发 出 .load bootstrap 命 令 。 保 存 的 REPL" 文 
件 放 在 project/.meteor/local/build/programs/server/ 文 件 夹 中 。 同 一 个 项 目 可 以 打开 多 个 外 壳 。 






























































说 明 默认 情况 下 ， 外 这 历史 文件 和 REPL 文 件 会 被 Git 忽 略 。 如 果 你 想 将 它们 添加 到 源 代码 库 ， 
必须 调整 相应 的 .gitignore 文 件 。 


11.2.2 使 用 node-inspector 进行 调试 


如 果 需 要 对 应 用 执行 更 复杂 的 服务 器 端 调 试 ，nodqe-inspector 是 一 个 方便 的 工具 。 它 是 
Node.js 中 一 个 基于 浏览 器 的 调试 接口 ,你 可 以 在 其 中 设置 断 点 、 检 查 源 文件 、 单 步 执行 程序 、 检 
查 变量 及 相关 的 值 。 

meteor CLI 工 具 的 debug 命 令 提 供 了 一 个 简单 的 方法 来 使 用 node-inspector。 请 确保 你 在 
项 目的 根 目录 并 且 该 项 目 目 前 没有 运行 。 然 后 发 出 这 个 命令 : 


$ meteor debug 


任何 基于 WebKit 的 浏览 器 都 能 够 运行 hode-inspector， 这 意味 着 Chrome 和 Safari 都 可 以 用 
来 访问 调试 URL。 但 是 ， 你 不 能 使 用 Firefox 或 I[E。 


& 






































说 明 在 调试 模式 下 ,使 用 http://localhost:3000 访 问 应 用 仍然 是 可 能 的 ,此 外 ,你 也 可 以 使 用 http:// 
localhost:8080/debug?port=5858 来 打开 调试 接口 。 














下 





g 它 代 表 Read-Eval-Print-Loop， 这 说 明 它 不 是 一 个 完全 交互 的 外 壳 ， 例 如 ， 你 的 命令 可 以 在 运行 时 查询 额外 的 盾 
输入 。 它 们 只 是 简单 地 读 取 和 执行 ， 结 果 打印 到 屏幕 上 。 
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一 旦 服务 器 启动 ,你 就 可 以 访问 应 用 和 调试 接口 。 如 果 你 没有 看 到 应 用 启动 ,请 转 到 调试 网 
址 检查 当前 的 运行 状态 。 如 果 代码 暂停 执行 ,可 以 在 右边 栏 最 上 方 看 到 一 个 消息 图 标 , 就 像 图 11-5 
显示 的 那样 。 单 击 工具 栏 左 侧 的 暂停 箭头 可 继续 程序 的 执行 。 














进入 下 一 个 
国 数 调用 跳出 当前 函数 








单 步 步 过 下 一 
个 函数 调用 一 


a 


使 用 这 个 图 标 。 一 *| .A | 二 | 险 | Paused + 显示 当前 是 否 
fs re 0 Pp Watch Expressions +ce 在 代码 执行 的 
TY Call Stack 暂停 状态 


{anonymous function) main.js:7 


















































图 11-5” 右 侧 栏 项 部 的 图 标 ， 可 单 步 执 行 函数 、 和 暂停 执行 

该 应 用 将 照常 运行 ， 但 你 现在 可 以 使 用 调试 控制 台 检 查 服务 器 上 代码 执行 过 程 中 发 生 的 情 
况 。 两 个 最 重要 的 工具 是 设置 断 点 和 检查 、 修 改变 量 内 容 。 

断 点 是 定义 代码 执行 时 应 该 暂停 处 的 标记 , 这 样 每 个 步 又 可 以 单独 执行 ,以 此 确定 函数 或 代 
码 段 的 实际 行为 。 你 可 以 在 浏览 器 窗口 中 通过 单 击 文件 的 行 号 或 者 使 用 debugger ;语句 来 设置 断 
点 。 代 码 清单 11-4 显 示 了 一 个 简单 的 例子 ， 在 代码 执行 暂停 后 ， 其 中 status 变 量 立 刻 被 赋值 为 
initialized。 使 用 node-inspector 可 以 检查 status 变 量 的 内 容 。 




















代码 清单 11-4 ”使 用 debugger ;设置 断 点 


if (Meteor.isServer) { 


Meteor.startup(function () { 
Var status = 'initialized'; 使 用 meteor debug 运 行 
debugger; i 
[9 文 将 上 \ 斩 令 
if (status === 'initialized'){ 时 ， 这 将 导致 应 用 暂停 
status = 'done' 


} 


console.log('status is now ' 


J 


+ status); 





将 鼠标 悬 停 在 变量 名 上 ， 它 的 内 容 将 显示 在 一 个 黄色 的 弹出 窗口 中 ， 右 边 的 作用 域 变量 
(Scope Variables， 在 这 里 你 可 以 修改 变量 的 值 ) 中 也 会 显示 。 要 在 其 他 文件 中 设置 断 点 或 检查 其 
他 文件 中 的 变量 内 容 ， 可 使 用 左上 角 的 图 标 打开 文件 导航 ( 参见 图 11-6 )。 





提示 如果 nodqe-inspector 没 有 像 预期 的 那样 运行 ， 请 尝试 刷新 浏览 器 。 


览 如 果 这 也 无 效 ， 使 
用 qebug 参 数 重 新 启动 Meteor。 
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打开 导航 先 
其 
反共 他 文件 “06 
// increment the counter when button is clicked 


14 5 Session,.set('counter', Session.get('counter') + 1); 





16| 0}); (anonymous app/debugAppjs22 
17|} function) 


2 if (Meteor,isServer) { (anonymous function) bootjs:212 




















悬 停 鼠标 可 查 v Scope Variables 
看 变量 的 内 容 v Local 


status: "debugging" 
bb this: global 


bp Global Object 
v Breakpoints 


No Breakpoints 














设置 断 点 pO; 
@ | {} | Une22, Column 1 





25 
26 
27 
单 击 行 号 一 一 ” 强 | 
39 
ED 









在 这 里 修改 变量 
图 11-6 ”使 用 node-inspector 检 查 和 更 改变 量 的 内 容 


node-inspector 是 一 个 强大 的 工具 ， 使 你 能 够 获得 宝贵 的 能 力 来 洞察 应 用 的 行为 。 要 了 解 
它 的 所 有 功能 , 可 看 看 该 项 目 GitHub 页 面 上 的 文档 : https://github.com/node-inspector/node-inspector。 























11.3 ”创建 浏览 器 应 用 

应 用 可 以 支持 一 个 或 多 个 平台 。 默 认 情 况 下 ， 所 有 的 新 项 目 都 支持 服务 器 和 浏览 器 平台 。 如 
前 所 述 ， 你 可 以 通过 下 面 的 命令 查看 项 目 支持 的 所 有 平台 列表 : 

$ meteor list-platforms 

除非 你 已 经 添加 了 额外 的 平台 ， 和 否则 输出 将 显示 prowser 和 server。 要 把 一 个 应 用 部 署 到 
服务 器 上 ， 必 须 先 将 其 打包 。 其 输出 和 meteor run --production 输 出 相似 ,但 是 没有 必要 连 
续 运 行 以 及 监视 文件 的 更 改 。 








区 


说 明 在 版 本 1.0 中 ，Meteor 项 目 必须 包含 服务 器 平台 。 不 可 能 仅仅 只 构建 浏览 器 平台 。 


11.3.1 使 用 Meteor.settings 进行 应 用 配置 


早期 我 们 讨论 过 只 在 服务 器 端 存储 配置 数据 ， 比 如 API 密 钥 等 。 但 也 有 多 个 服务 器 环境 存在 
的 情况 ,其 中 有 专用 的 开发 、 测 试 和 生产 环境 服务 器 。 每 个 可 能 需要 不 同 的 设置 ,这 就 是 为 什么 
把 配置 数据 存储 在 代码 文件 中 是 不 高 效 的 ， 它 应 该 存储 在 一 个 配置 文件 中 。Meteor 可 以 有 一 个 
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JSON 文 件 ， 它 通过 Meteor .settings 对 象 来 暴露 其 内 容 。 这 意味 着 你 可 以 使 用 这 样 的 代码 
Meteor.settings.oauth.twitter.apikey 而 不 是 一 个 字符 串 。 下 面 的 代码 清单 显示 了 


Meteor 设 置 的 配置 文件 结构 。 


代码 清单 11-5 ”通过 settings.json 设 置 应 用 的 配置 选项 
{ 











"oauth"™: + 
"twitter": { 
"apikey": "123abe";, 
"secret": "abc123" 
} 
; 
oul el eb 
Wer SLOn i my 


} 
} 


默认 情况 下 ,Meteor 不 会 使 用 设置 文件 ,设置 文件 必须 在 命令 行 上 通过 --settings 参 数 指 定 。 
要 使 用 一 个 名 为 settings.json 的 文件 ， 用 下 面 的 命令 启动 项 目 : 























$ meteor run --settings settings.json 
或 者 ， 你 可 以 把 JSON 配 置 对 象 存 储 在 Meteor . settings 环 境 变量 中 。 无 论 采 用 哪 种 方式 ， 
你 都 可 以 访问 设置 对 象 的 属性 ， 如 代码 清单 11-6 所 示 。 





说 明 使 用 Meteor.settings 的 时 候 , 在 启动 Meteor 服 务 器 时 需 提供 设置 对 象 , 否则 会 遇 到 错误 。 


代码 清单 11-6 使 用 JSON 配 置 文件 中 的 值 来 设置 Meteor .settings 


if (Meteor.isServer) { 
console.log("Using the following API Key for Twitter"); 


console.log(Meteor.settings.oauth.twitter.apikey); 


} 
一 个 八 


配置 文件 在 客户 端 上 是 不 可 用 的 ， 但 你 可 以 使 用 Meteor .settings .public 来 访问 一 个 公 
共 字 段 中 存储 的 所 有 配置 。 该 public 字 段 以 外 的 任何 内 容 都 不 能 在 客户 端 上 访问 ， 因 此 可 以 安 


全 地 用 于 敏感 的 配置 。 
使 用 不 同 的 设置 文件 , 你 可 以 轻松 地 在 不 同 阶 段 以 及 生产 环境 中 运行 应 用 , 在 不 同 的 环境 中 


使 用 不 同 的 数据 库 和 应 用 接口 。 


























11.3.2 ”构建 Meteor 项 目 
可 以 使 用 Meteor 的 meteor build 命令 创建 一 个 应 用 的 包 "。 输 出 是 格式 为 压缩 文件 的 完整 

















Q@ 此 处 的 包 指 bundle， 它 指 一 个 应 用 ， 而 不 是 前 面 提 到 的 Meteor 包 或 npm 包 。 一 一 译 者 注 
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Node.js 应 用 。 如 果 需 要 的 话 ，bui1g 命 令 可 以 改 为 创建 一 个 和 压缩 文件 具有 相同 内 容 的 目录 。 
创建 包 很 简单 ， 只 需 进 入 应 用 的 根 目 录 , 调用 命令 时 使 用 一 个 参数 说 明 要 创建 的 输出 文件 。 


提示 当 你 创建 一 个 压缩 文件 时 ,将 输出 放 在 当前 项 目 文件 夹 中 通常 没 问 题 ,但 由 于 各 种 原因 ， 
最 好 把 它 放 在 别处 。 首 先 ， 你 可 能 不 小 心 把 它 添加 到 源 代码 库 ， 除 非 你 显 式 地 添加 一 个 
规则 来 忽略 这 个 文件 。 第 二 ， 如 果 你 决定 创建 一 个 目录 而 不 是 一 个 文件 ， 或 者 为 另 一 个 
平台 构建 应 用 时 ， 所 产生 的 文件 在 你 使 用 meteor fun 时 会 被 解释 为 额外 的 源 文件 ， 因 此 
会 产生 错误 消息 。 





要 将 Meteor 应 用 的 压缩 包 文 件 放 在 当前 项 目 父 文件 夹 中 的 builds 目 录 下 ， 请 使 用 以 下 命令 : 


$ cd myMeteorProject 
$ meteor build ../builds 


生成 的 tar.gz 文 件 中 包含 编译 过 的 Meteor 应 用 ,你 可 以 把 它 放 在 一 个 服务 器 上 ,解压 并 运行 ( 更 
多 细节 可 参考 第 12 章 ) 

你 会 注意 到 ， 整 个 目录 结构 相对 于 原来 的 项 目 组 织 结构 已 经 有 了 很 大 的 变化 (参见 图 11-7 )。 
你 现在 将 看 到 两 个 主要 文件 夹 : 程序 (programs ) 和 服务 器 ( server )， 而 不 是 客户 端 (client )、 
服务 器 和 公共 (public ) 文件 夹 。 所 有 相关 的 代码 都 位 于 程序 文件 夹 中 ， 按 照 平台 进行 组 织 。 在 
服务 器 文件 夹 中 ， 所 有 模块 、 包 和 资源 都 存储 其 中 。 资 源 (assets ) 和 私有 (private ) 文件 夹 的 内 
容 被 以 不 同 的 方式 处 理 ， 因 为 它们 被 移动 到 了 压缩 包 的 资源 目录 中 。 其 他 内 容 都 被 移动 到 应 用 
(app ) 目录 ,测试 (tests ) 文件 夹 是 一 个 例外 ， 因 为 它 不 会 被 放 进 生产 包 中 。 

所 有 需要 发 送 到 浏览 器 的 资源 存储 在 web.browser 文 件 夹 。 运 行 meteor build 意味 着 使 用 
--production 选 项 ， 所 以 这 里 有 三 个 重要 的 文件 : HIML、CSS 和 JavaScript。 此 外 ， 公 共 目 录 
的 静态 资源 被 复制 到 客户 端 平台 ， 可 以 在 应 用 目录 中 找到 。 

你 会 注意 到 一 些 其 他 的 文件 ， 它 们 之 前 并 不 存在 ， 比 如 main.js。 这 些 文件 是 自动 生成 的 ,其 
中 包括 将 该 项 目 作 为 普通 Node.js 应 用 来 运行 时 所 需 的 主要 构件 。 
虽然 meteor build 使 用 简单 ， 但 它 在 可 移植 方面 有 一 定 的 局 限 性 。 只 要 你 不 依赖 于 平台 相 
关 的 二 进 制 npm 模 块 ， 把 一 个 应 用 从 Mac OS X 开 发 系统 移植 到 Ubuntu Linux 服 务 器 时 ， 应 该 不 会 
遇 到 任何 问题 。 在 某 些 高 级 的 用 例 中 ， 如 果 需 要 真正 可 移植 的 Node.js 应 用 ，demeteorizer 是 个 
比较 灵活 的 工具 。 可 参考 第 12 章 进一步 了 解 如 何 使 用 它 。 
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应 用 程序 资源 Isobuild 应 用 包 

















» Bl tests 

assets 和 private 目 录 下 上 ed ! 
的 文件 被 移动 到 assets | ~ 国 20ae2c8d51b2507244e598844414ecdec2615ce3.css |; 
一 | ~ 20ae2c8d51b2507244e598844414ecdec2615ce3.css.map | 
client 目 录 下 的 所 有 文件 | app | 
被 合并 和 缩小 到 web.bro- 园 image.png : 
wser 下 的 三 个 文件 | 昌 ce21bb8297f30ff1f1d81a0039aa1c8c732a60a9.js | 
PE Ea | @ head.html | 
所 有 其 他 的 内 容 被 移 二 
到 app 目 录 上 README 

ER v BM server 

了 了 .bundle_version.txt 
应 用 包 中 不 包含 tests 目 录 starjson 


图 11-7 meteor buila 的 输出 





11.4 创建 移动 应 用 


在 智能 手机 和 平板 电脑 上 运行 的 应 用 通常 类 似 于 Web 应 用 。 它 们 在 一 个 应 用 容器 中 矢 人 应 
用 ， 而 不 是 使 用 浏览 器 。 这 样 ， 它 们 将 基于 HTMLS 的 客户 端 /服务 器 型 网 站 和 原生 应 用 组 合 在 一 
起 ,这 也 是 它们 被 称 为 混合 ( hybrid ) 应 用 的 原因 。Meteor 利 用 Cordova 的 功能 来 提供 对 移动 平台 
的 支持 。 




















11.4.1 ”使 用 Cordova 的 混合 应 用 


Cordova" 是 一 个 框架 ， 它 将 HTML、JavaScript 和 CSS 转 换 为 一 个 原生 的 应 用 ， 可 以 在 iOS 或 
Android 这 样 的 移动 平台 上 运行 。 它 提供 了 Web 视 图 的 一 个 原生 封装 ( 可 以 认为 它 是 一 个 能 入 式 浏 











Q@ 如果 你 想 了 解 更 多 关于 Cordova 的 内 容 ， 可 以 参考 Raymond K. Camden 的 Apache Cordova in Action。 
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览 器 )， 并 可 以 访问 如 相机 或 全 球 定位 系统 这 样 的 硬件 功能 。 对 用 户 来 说 ,创建 在 Cordova 之 上 的 
应 用 ， 其 外 观 和 行为 完全 和 原生 应 用 一 样 。 它 们 通过 应 用 商店 分 发 ， 所 以 为 了 出 售 Meteor 的 移动 
应 用 ， 你 必须 是 苹果 或 谷歌 的 开发 者 。 

Cordova 是 一 个 开源 的 Apache 项 目 , 可 以 免费 使 用 。 另外 PhoneGap 也 通常 用 来 指 代 这 个 工具 。 
从 技术 上 说 ，PhoneGap 是 由 Adobe 维 护 的 一 个 Cordova 发 行 版 本 ， 提 供 了 一 些 需要 付费 的 功能 。 
为 把 让 Meteor 应 用 运行 在 移动 设备 上 , 从 现在 开始 , 我 们 将 仅仅 使 用 Cordova, 但 是 在 谷歌 和 Stack 
Overflow 上 ， 大 多 数 时 候 你 可 以 交换 使 用 这 两 个 术语 。 

1. Cordova 的 功能 

Cordova 可 以 为 Meteor 应 用 添加 的 最 重要 的 优势 是 Web 浏 览 器 外 过 ,这 使 它 看 起 来 和 在 行为 上 
都 像 一 个 应 用 。 这 个 外 过 允许 应 用 在 应 用 商店 被 购买 , 并 且 可 以 直接 运行 而 不 需要 知道 使 用 哪个 
服务 器 URL。 

通过 使 用 插件 ，Cordova 可 以 访问 设备 的 硬件 ， 和 设备 上 的 其 他 应 用 交换 数据 。 这 些 插 件 提 
供 了 一 些 API， 可 由 此 使 用 摄像 头 、 访 问 联系 人 ， 甚 至 实现 应 用 内 购买 。 

Cordova 所 有 可 用 插件 的 完整 列表 ， 可 以 在 http://plugins.cordova.io/ 找 到 。 一 些 插 件 也 可 以 
Meteor 包 的 形式 使 用 。Meteor 开 发 小 组 提供 以 下 的 包 。 
允许 应 用 访问 设备 的 相机 。 
DQ mdg:geolocation 提供 设备 GPS 的 响应 式 接口 。 
D mdg:reload-on-resum 延迟 热 码 推动 ， 直 到 应 用 关闭 和 重新 打开 。 
2. Cordova 的 局 限 性 
虽然 它 可 以 很 容易 地 把 HIML5S 应 用 转变 为 移动 应 用 ,但 它 仍然 像 浏览 网 页 一 样 。 别 指望 DOM 
泻 染 和 用 Java 写 的 图 形 密集 型 动作 游戏 有 相同 的 性 能 。 这 样 说 吧 ， 许 多 应 用 在 现代 设备 上 肯定 会 
运行 得 很 好 。 

为 Cordova 只 是 Web 应 用 的 外 这， 所 以 它 不 提供 UI 框架 或 实施 设计 指南 。 


11.4.2 ”加 入 移动 平台 


Meteor 支 持 两 个 移动 平台 : Android 和 iOS。 当 它们 中 的 一 个 被 添加 到 项 目 中 时 ，buila 命 令 
将 不 仅 生成 一 个 压缩 文件 包 ， 也 会 生成 一 个 有 效 的 Android Studio 或 Xcode 项 目 。 在 开发 过 程 中 ， 
没 必要 打开 这 两 个 工具 ， 因 为 Meteor 能 够 在 模拟 器 内 运行 应 用 。 

1. 先决 条 件 

在 一 个 项 目 中 添加 移动 平台 之 前 ， 你 必须 在 开发 机 器 上 安装 每 个 平台 的 SDK。iOS SDK 只 在 
Mac OS X 上 可 用 ， 因 此 你 也 需要 安装 苹果 的 Xcode。 在 Linux 或 Windows 上 构建 :OS 应 用 是 不 可 能 
的 。 你 使 用 下 面 这 些 meteor 命 令 来 安装 SDK: 


$ meteor install-sdk ios 
$ meteor install-sdk android 


你 必须 接受 iOS SDK 的 许可 协议 。 如 果 得 到 一 个 错误 信息 ， 请 尝试 打开 Xcode 并 单 击 协议 。 



















































































D mdg:camera 
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Android SDK 有 一 个 专门 的 配置 界面 ， 它 也 可 以 通过 meteor CLI 工 具 调用 。 你 可 以 使 用 这 个 界面 
下 载 更 新 或 管理 模拟 器 使 用 的 设备 。 在 你 开始 将 应 用 转变 为 Android 应 用 之 前 ， 没 有 必要 进行 任 
何 配置 ， 所 以 我 们 不 会 讨论 这 个 工具 的 细节 。 如 果 你 需要 Android SDK 管 理 器 ， 可 以 用 这 个 命令 
启动 它 : 

$ meteor configure-android 


2. 添加 平台 
要 让 Meteor 应 用 在 移动 设备 上 运行 ， 需 要 在 项 目 中 添加 相应 的 平台 。 为 此 ， 可 使 用 以 下 的 一 


个 或 两 个 命令 : 





























$ meteor add-platform ios 
$ meteor add-platform android 


Meteor 的 构建 过 程 将 会 自动 配置 , 包括 生成 其 中 一 个 平台 上 应 用 所 需 的 步骤 。 但 meteor run 
不 会 自动 运行 你 的 移动 应 用 ; 你 需要 在 run 命 令 中 添加 平台 名 称 作 为 参数 ， 如 下 所 示 : 


$ meteor run ios 
$ meteor run android 


这 个 命令 将 编译 应 用 , 并 在 一 个 模拟 的 苹果 或 安 卓 设备 中 打开 它 。 虽然 应 用 本 身 不 会 使 用 平 
台 的 任何 用 户 界面 指南 , 但 所 有 的 输入 字段 ( 如 下 拉 列 表 和 文本 框 ) 将 依赖 于 设备 的 默认 界面 ( 参 
见 图 11-8 )。 








安 卓 浏览 器 iOS 





Mobile Meteor App Home | | have no idea where you are! 


Let's go Make a selection 
Where are you? 


1 have no idea where you are! 
Make a selection 
Android 


WwW Browser 





ioS 
Server 























图 11-8 ”Cordova 应 用 使 用 设备 特定 的 默认 输入 界面 ， 例 如 下 拉 列 表 
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如 果 要 在 实际 设备 中 运行 Meteor 应 用 ， 就 需要 使 用 Xcode ( https://developer.apple.com/ 
library/mac/documentation/ides/conceptual/appdistributionguide/launchingyourappondevices/launchi 
ngyourappondevices.html ) 或 根据 官方 帮助 设置 一 个 安 卓 设备 进行 测试 ( http://developer.android. 
com/tools/ device.html#setting-up )。run 命 令 必须 包含 设备 参数 来 告诉 Meteor 使 用 实际 的 硬件 ， 
而 不 是 模拟 器 : 

$ meteor run ios-device 

$ meteor run android-device 


提交 到 应 用 商店 

Meteor 不 会 创建 一 个 可 以 直接 提交 给 应 用 商店 的 移动 应 用 。 对 Android 和 iOS 而 言 ， 你 仍然 
需要 完成 发 布 应 用 的 必要 步骤 ， 就 像 任何 其 他 移动 应 用 一 样 。 但 你 不 需要 在 Xcode 或 Android 
Studio 中 写 任何 代码 。 你 可 以 使 用 这 些 工具 来 完成 发 布 应 用 的 最 后 工作 。 

让 你 的 移动 应 用 在 智能 手机 或 平板 电脑 运行 的 首 个 先决 条 件 是 加 入 开发 者 计划 。 对 这 两 个 
平台 而 言 ， 这 包括 注册 和 付费 。 然 后 你 就 可 以 提交 应 用 到 谷歌 Play 商店 或 苹果 的 iTunes 商 店 。 

具体 情况 可 能 会 有 所 改变 ,所 以 你 应 该 按照 官方 的 程序 来 创建 一 个 应 用 , 这 些 都 是 你 需要 
遵循 的 基本 步骤 。 一 旦 有 了 开发 人 员 帐 户 , 你 将 获得 一 个 用 来 签署 应 用 代码 的 证 书 。 此 证 书 用 
于 验证 这 个 应 用 是 你 的 , 而 不 是 其 他 人 以 你 的 名 义 进行 发 布 的 。 该 证书 通 常 带 有 一 个 发 布 的 配 
置 文件 ， 其 中 列 出 了 公司 信息 ,而 最 重要 的 是 应 用 的 唯一 标识 符 。 














当 你 需要 把 项 目 发 布 到 移动 设备 上 时 ， 键 和 人 meteor pui1g 命 令 创建 所 需 的 Xcode ( 为 iOS 
发 布 时 ) 或 Android Studio 项 目 文件 。 事 实 上 ， 所 有 的 平台 都 是 由 这 个 命令 构建 的 。 因 为 移动 设 
备 不 允许 用 户 像 浏览 器 那样 输入 URL, 所 以 builad 命 令 需要 一 个 额外 的 参数 来 指定 构建 过 程 中 的 
服务 器: 











$ meteor build ../builds --server=http://mobile.meteorinaction.com 


请 确认 Meteor 应 用 可 以 在 给 定 的 服务 器 URL 上 运行 ， 否 则 应 用 可 能 在 模拟 器 内 可 以 完美 运 
行 ， 但 一 旦 部 署 到 实际 的 硬件 设备 就 不 工作 了 。 此 外 ,在 提交 应 用 到 商店 之 前 请 检查 服务 器 的 
URL 是 否 正确 。 






































11.4.3 ”配置 移动 应 用 


通过 更 改 默 认 配 置 ， 你 可 以 自 定义 移动 应 用 。 在 项 目的 根 目录 使 用 mobile.config.js 文 件 可 以 
管理 应 用 的 图 标 、 启 动 屏 幕 、 应 用 元 信息 以 及 插件 的 设置 。 

1. 使 用 App .info() 获 得 应 用 元 信息 

App.info() 保 存 了 一 个 对 象 ， 其 中 包含 了 应 用 更 多 的 信息 。 它 使 用 了 以 下 属性 。 

口 id 一 一 唯一 的 反 向 域名 标识 符 。 
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口 version 一 一 使 用 x.y.z 格 式 的 完整 版 本 号 。 

口 name 一 一 显示 在 设备 的 主屏 幕 上 ， 并 在 应 用 商店 中 使 用 。 
口 description 用 在 应 用 商店 中 。 

DQ author 用 在 应 用 商店 中 。 

口 email 一 一 用 于 在 应 用 商店 进一步 指定 作者 的 信息 。 

口 website 一 一 用 于 在 应 用 商店 进一步 指定 作者 的 信息 。 





所 有 键 都 需要 一 个 字符 串 值 ， 如 下 面 的 代码 清单 所 示 。。 
代码 清单 11-7 “一 个 移动 应 用 的 App .info () 示 例 


App.infol(t{ 
Los 'com.meteorinaction.mobile.app', 
version: i 
name: 'Meteor in Action Mobile App', 
description: 'This is a mobile app for Meteor in Action'， 
author: 'Stephan Hochhaus', 
email: 'stephan@meteorinaction.com', 
website: 'http://meteorinaction.com' 


上 


2. 图 标 和 启动 屏幕 

要 自 定义 设备 屏幕 上 显示 的 logo 和 应 用 启动 时 的 屏幕 ， 可 以 使 用 API 命 令 App.icons() 和 
App .launchScreens () 。 它 们 在 没有 设置 的 情况 下 ， 会 使 用 Meteor 的 默认 图 标 和 启动 屏幕 。 不 
同 的 设备 会 使 用 不 同 的 分 辨 率 , 这 就 是 为 什么 这 两 个 命令 都 需要 不 同 的 属性 。 对 于 应 用 商店 中 的 
发 布 而 言 ， 所 有 尺寸 的 屏幕 必须 配置 一 个 专用 的 图 标 和 启动 屏幕 。 请 检查 本 章 代 码 示例 中 的 
mobileApp 以 获得 当前 支持 的 所 有 设备 类 型 列表 。 下 面 的 代码 清单 显示 了 如 何在 mobile-config.js 
文件 中 使 用 它们 。 


代码 清单 11-8 ”在 mobile.config.js 中 设置 图 标 和 启动 屏幕 
App.icons(t{ 
'iphone': 'icons/iphone.png', 
'android_ ldpi': 'icons/android-launcher.png', 
有 















































App.launchScreens ({ 


'iphone': 'icons/splash-iphone.png', 
'androiqd_ ldpi_portrait': 'icons/splash-ldpi portrait.png', 
他 
3. 和 白 名 单 URL 





在 Web 浏 览 器 中 ,你 的 应 用 可 能 在 你 不 知道 的 情况 下 从 不 同 的 URL 请 求 额外 的 信息 。 为 安全 | 
起 见 ，Cordova 应 用 不 允许 访问 任意 的 URL。 只 有 在 mobile-config.js 文 件 的 白 名 单 中 指定 的 URL 
才 可 以 访问 。 每 个 允许 的 URL 使 用 App .accessRule 来 定义 ， 其 语法 为 : 


App.accessRule(domainRule, {launchExternal: false}) 
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domainRule 可 以 是 任何 URL， 子 域名 可 使 用 占 位 符 。 不 需要 设置 其 他 选项 。 唯 一 可 能 的 选 
项 是 launchExternal， 这 将 允许 Cordova 应 用 在 移动 设备 上 加 载 外 部 应 用 的 一 个 URL。 代 码 清 
单 11-9 给 出 了 一 个 典型 的 访问 规则 的 例子 。 














说 明 当 你 的 移动 应 用 需要 依赖 来 自 外 部 API 的 内 容 时 , 你 必须 声明 访问 规则 以 允许 应 用 访问 远 
程 URL。 


代码 清单 11-9 在 mobile.config.js 中 声明 URL 访 问 规则 














App.accessRule('https://*.googleapis.com/*');} ey 
App.accessRule('https://*.google.com/*'); 0 es 的 
App.accessRule('https://*.gstatic.com/*'); n 

， ， 允许 访问 Twitter 
App.accessRule('https://pbs.twimg.com/*'); 个 人 信息 中 的 图 像 
App.accessRule('http://graph.facebook.com/*'); | 
App.accessRule('https://graph.facebook.com/*'); 个 人 信息 中 的 图 像 


4. 配置 Cordova 插 件 

除了 Isopack 和 npm 模 块 ，Meteor 也 支持 Cordova 捅 件 。mobile-config,js 文 件 也 可 以 用 来 配置 这 
些 插件 。 你 可 以 通过 app.setPreference () 来 设置 WebKit 容 需 。 从 技术 上 说 ， 它 允许 你 设置 
Cordova config.xml 文 件 中 preference 标 签 的 值 。 

Cordova 插 件 可 以 使 用 App .configurePlugin() 来 配置 。 它 们 也 使 用 简单 的 键 值 对 风格 进 
行 配置 ， 所 以 这 个 命令 需要 两 个 参数 : 插件 的 名 称 和 提供 键 值 对 的 配置 对 象 。 

下 面 的 代码 清单 显示 了 如 何 配 置 全 局 偏好 以 及 facebookconnect 插 件 。 


代码 清单 11-10 ”配置 应 用 的 行为 和 Cordova 插 件 


App.setPreference('BackgroundColor', '0xff0000ff'); 
App.setPpreference('HideKeyboardFormAccessoryBar', true); 


























App.configurePlugin('com.phonegap.plugins.facebookconnect', { 
APP_ID: '1234567890 ' ， 
API_KEY: 'apikey' 

3 


11.4.4 添加 移动 功能 


虽然 将 现 有 的 浏览 器 应 用 变 成 移动 应 用 是 不 难 的 , 但 到 目前 为 止 , 我 们 还 没有 向 你 展示 如 何 
添加 任何 移动 特定 的 功能 。 类 似 于 isserver() 和 isclient1() 方 法 ， 你 可 以 使 用 Meteor . 
isCordova() 函数 来 指定 仅 在 移动 平台 上 运行 的 代码 ; 


if (Meteor.isCordova) { 
console.log('Printed only in mobile cordova apps'); 


} 
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使 用 这 个 条 件 是 添加 移动 功能 最 简单 的 方法 ， 但 它 不 允许 访问 设备 的 功能 。 要 做 到 这 一 点 ， 
你 必须 改进 现 有 的 应 用 。 

Cordova 类 似 于 Meteor， 它 使 用 很 小 的 核心 功能 集 并 利用 插件 来 进行 扩展 。 如 果 某 个 功能 
可 以 通过 添加 一 个 Isopack 包 ( 比如 mdg :geolocation ) 来 实现 ， 它 的 用 法 就 和 大 多 数 其 他 包 
一 样 。 

任何 依赖 于 Cordova/PhoneGap 插 件 的 功能 应 该 包 在 Meteor.startup() 代码 块 中 。 就 
mdg :geolocation 而 言 ， 你 需要 这 样 的 代码 : 

Meteor .startup (Eunction () { 


Geolocation.currentLocation(); 
二 


我 们 不 会 讨论 使 用 某 个 包 的 细节 ， 现 在 来 看 看 男 一 种 扩展 应 用 功能 的 方式 ， 即 将 Cordova 插 
件 整合 到 一 个 应 用 中 。 有 两 种 类 型 的 插件 : 同 核心 捆绑 在 一 起 的 插件 ( 可 以 通过 它们 名 字 的 前 组 
org.apache.cordova 来 识别 ) 和 第 三 方 插件 ,它们 可 以 在 官方 插件 注册 的 地 方 http://plugins.cordova. 
io/ 和 GitHub 上 找到 。 




















说 明 不 要 把 移动 代码 包 在 isServer() 块 中 或 把 它 放 在 服务 器 文件 夹 中 , 因为 最 终 它 将 在 移动 
客户 端 设备 上 运行 。 























让 我 们 看 一 个 例子 ， 说 明 如 何在 Meteor 中 使 用 普通 的 Cordova 插 件 。 我 们 将 使 用 aialogs 插 
件 ， 它 为 应 用 提供 了 原生 用 户 界面 中 的 对 话 框 元 素 。 首 先 ， 通 过 meteor add 添 加 它 。 因 为 它 是 
一 个 Cordova 插 件 ， 所 以 使 用 了 cordova: 前 级 。Meteor 不 会 像 对 Isopacks 包 那样 进行 一 致 性 和 兼 
容 性 检查 ， 所 以 你 必须 指定 一 个 特定 的 版 本 ， 而 不 是 依靠 版 本 求解 右 来 确定 正确 的 版 本 : 


$ meteor add cordova:org.apache.cordova.dialogs@0.3.0 


这 样 ， 使 用 meteor list 时 ，daialogs 搬 件 将 和 所 有 其 他 包 一 起 列 出 。 代 码 清单 11-11 显 
示 了 如 何 基于 Meteor 的 默认 项 目 创建 原生 的 对 话 框 。 在 事件 映射 中 ， 你 为 一 个 选择 框 的 
change 事 件 添加 了 一 个 额外 的 对 话 框 , 并 将 其 包 在 一 个 iscordova() 块 中 , 以 防止 它 在 浏览 
器 中 执行 。Meteor 可 以 直接 使 用 捅 件 ， 没 必要 将 它 包 在 API 调 用 中 。 用 于 普通 Cordova 应 用 的 
navigator. notification.alert 也 同样 可 以 用 在 这 里 。 它 需 要 四 个 参数 : 字符 串 形式 的 
对 话 框 消息 、 警 告 被 解除 时 的 一 个 回调 函数 ( 这 里 是 nul1 )、 对 话 框 标题 (默认 Alert ) 和 按 
钮 名 称 ( 默认 OK )。 


wy 










































































代码 清单 11-11 在 change 事 件 中 加 入 Cordova 的 对 话 框 (aialogs ) 插件 
Template.select.events({ 仅 在 移动 设备 上 
change #platform': function (evt) { 执行 此 代码 块 
Var selectedPlatform = evt.currentTarget .value; 
if (Meteor.isCordova) { = 
navigator.notification.alert!( 创建 一 个 
对 话 框 
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'You picked ' + selectedPlatform, 
消息 文本 null, 


'Your choice', | 8 
ey 的 回调 函数 
navigator.notification.alert( 对 话 框 标题 

'You selected', 

0 按钮 文本 
} else { 


console.log('selected ' + selectedplatform) 
} 
} 
}; 


11.5 总结 


在 本 章 中 ， 你 已 经 了 解 到 以 下 内 容 。 

口 尽管 JavaScript 不 是 一 种 编译 语言 ， 但 Meteor 应 用 在 运行 之 前 需要 进行 构建 (编译 )。 
口 当 你 使 用 --production 参 数 运行 zun 命 令 时 ， 所 有 的 文件 将 被 缩小 。 

口 文件 的 加 载 顺 序 基 于 目录 的 层次 结构 和 文件 名 。 

口 构建 过 程 可 以 通过 使 用 包 来 扩展 ， 如 coffeescript 或 less 包 。 

口 默认 情况 下 ， 所 有 的 项 目 都 在 服务 器 浏览 需 的 场景 中 被 构建 。 

口 添加 移动 平台 会 扩展 构建 过 程 ， 它 将 使 用 Cordova 为 OS 或 Android 创 建 混合 应 用 。 

口 Cordova 插 件 可 以 在 Meteor 中 直接 使 用 ， 它 们 没 必 要 封装 在 Isopack 中 。 
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本 章 内 容 

口 如 何 组 织 代码 以 方便 部 署 

口 使 用 Velocity 集 成 测试 框架 

口 负载 估算 和 测试 

口 了 解 部 署 选 项 ， 从 简单 到 高 度 可 用 
口 使 用 Meteor UP 部 署 应 用 

口 使 用 环境 变量 配置 服务 器 

口 构建 高 可 用 架构 





当 所 有 的 功能 都 已 实现 、 错 误 都 已 修复 ，Meteor 应 用 就 到 了 进入 生产 环境 的 时 候 了 。 本 章 涵 
盖 了 部 署 Meteor 应 用 的 所 有 基本 要 素 。 我 们 不 会 讨论 服务 器 管理 的 具体 细节 ,但 会 探索 典型 的 架 
构 以 及 小 规模 和 可 扩展 部 署 的 可 能 选项 ， 这 样 当 你 的 应 用 获得 成 功 时 你 就 知道 应 该 怎么 做 。 

在 理想 的 情况 下 ， 甚 至 在 开始 写 一 行 代码 之 前 ， 你 就 已 经 想到 了 让 应 用 “上 线 "。 如 果 你 还 
没有 ,那么 现在 是 时 候 重新 审视 项 目的 期 望 和 要 求 了 。 你 会 注意 到 部 署 选 项 受 需求 的 影响 很 大 。 
但 因为 大 多 数 大 规模 的 应 用 开始 时 都 很 小 , 所 以 我 们 将 从 最 简单 的 部 署 方 案 开 始 讨论 , 然后 在 下 
一 步 引入 更 大 的 规模 和 复杂 性 。 


12.1 准备 生产 


在 最 基本 的 层面 上 , 把 项 目 部 署 到 生产 环境 意味 着 将 它 复 制 到 一 个 远程 服务 器 , 并 允许 用 户 
访问 。 从 这 一 刻 起 ,你 将 会 发 现 错误 、 计 划 额 外 的 功能 、 部 署 补丁 、 接 收 用 户 反 馈 ， 然 后 你 会 在 
两 个 环境 下 工作 : 生产 环境 和 开发 环境 。 在 将 代码 复制 到 服务 器 之 前 ， 让 我 们 先 看 看 在 生产 中 运 
行 应 用 的 一 些 有 用 的 基本 技术 。 


12.1.1 使 用 版 本 控制 


从 第 一 次 发 出 meteor create 命 令 的 那 一 刻 起 ， 你 就 在 准备 生产 。 除 非 你 是 在 黑客 马拉松 
中 而 且 永远 不 会 再 次 看 你 写 的 代码 ,不然 你 就 需要 把 项 目 放 入 版 本 控制 中 , 尤其 是 它 不 仅仅 只 有 
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几 行 代码 或 是 由 多 个 人 开发 的 时 候 。Git、Subversion 或 IBM ClearCase 等 系统 将 为 你 构建 一 个 代码 
的 安全 网 ， 而 且 它 们 也 有 助 于 开发 和 部 署 。 

对 部 署 而 言 , 当 你 第 一 次 把 文件 复制 到 服务 器 上 的 时 候 , 源码 控制 的 好 处 可 能 不 是 那么 明显 。 
但 是 在 你 决定 休假 2 个 星期 之 前 ， 你 怎么 知道 用 户 使 用 的 是 哪个 版 本 ， 付 费 客 户 的 问题 是 依然 存 
在 还 是 已 经 被 修复 了 ? 






























































提示 不 要 在 代码 库 的 根 目录 添加 你 的 Meteor 项 目 ， 而 要 添加 在 app 目 录 中 。 这 样 ， 你 也 可 以 将 
非 应 用 资源 ， 如 配置 文件 ， 添 加 到 同一 个 代码 库 中 。 





一 旦 准备 进入 生产 环境 ,你 就 应 该 有 一 个 专门 的 主 分 支 , 它 代 表 了 生产 质量 的 代码 ,每 次 部 
署 到 生产 环境 都 要 做 一 个 标签 。 这 种 方法 可 以 很 容易 地 看 到 正在 运行 的 应 用 使 用 的 是 什么 代码 。 

我 们 将 使 用 Git 来 过 一 饥 所 需 的 步 又 。 许 多 人 都 在 主 分 支 做 所 有 的 工作 ， 这 使 合并 变化 比 它 
应 有 的 复杂 度 要 高 得 多 。 应 该 使 用 一 个 分 支 用 于 所 有 的 开发 或 错误 修复 工作 , 并 且 只 让 可 以 工作 
的 代码 进入 主 分 支 。 











提示 使 用 Git 时 ， 请 确定 主 分 支 只 包含 最 新 的 和 稳定 的 代码 。 不 应 该 在 主 分 支 进 行 任何 开发 工 
作 ， 应 该 在 专用 的 开发 或 功能 分 支 进行 开发 。 


在 Git 版 本 库 中 ， 一 个 简单 的 项 目 可 能 类 似 于 图 12-1。 

所 有 的 开发 都 发 后 在 一 个 专门 的 devel 分 支 。 一旦 开发 完成 并 且 通 过 了 所 有 的 测试 , 将 代码 合 
并 到 主 分 支 并 标记 版 本 号 ( 如 v1.0 )。 

使 用 多 个 分 支 的 优点 是 你 可 以 为 应 用 添加 还 不 想 部 署 的 功能 , 还 可 以 修复 生产 代码 中 的 关键 
问题 ， 而 不 必 在 线 上 冒险 合并 未 经 测试 的 开发 代码 。 

在 我 们 的 场景 中 , 你 已 经 成 功 将 稳定 的 代码 部 署 到 生产 并 标记 为 v1.0。 在 下 一 个 版 本 2.0 的 工 
作 中 ， 你 发 现 了 一 个 关键 的 问题 需要 修复 。 要 进行 这 个 修复 ， 你 创建 了 一 个 新 的 分 支 ， 称 为 
hotfix-v1.0。 一 旦 在 hotfix 分 支 修复 了 问题 并 完成 了 代码 测试 ， 你 将 它 合并 到 主 分 支 。 所 有 这 一 切 
都 不 会 被 任何 可 能 在 开发 环境 下 发 生 的 事情 所 影响 ”。 

在 一 个 项 目 上 工作 的 人 越 多 或 者 应 用 越 复杂 , 就 越 可 能 使 用 更 多 的 分 支 。 你 只 要 确保 在 任何 
时 候 都 能 轻松 地 跟踪 生产 中 使 用 的 代码 。 

一 些 供应 商 ， 如 Heroku， 在 从 源码 控制 中 部 署 应 用 时 ， 默 认 采 用 上 面 的 规则 。 在 前 面 的 示例 
中 ， 他 们 假定 主 分 支 包含 了 稳定 的 代码 。 

































































@ 你 可 以 在 以 下 网 址 找到 这 种 分 支 模型 更 深入 的 解释 : http://nvie.com/posts/a-successful-git-branching-model/。 
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标 


签 表明 生产 的 发 布 








| Al/ Branches $| | Show Remote Branches $|| Ancestor Order $$| 








主 分 支 总 是 包 
含 稳定 的 代码 









Description Commit 
grtignore update errde85 
Merge branch "devops’ 21c4ca7 
J originidevops || YW devops | added sample init script 32f6b17 
WW v2.0| Merge branch “devel' 8b7d660 
Merge branch ‘hotfix-v1.0' fD4f077 
J hotfix-v1.0| hotfix for task descriptions e147ae3 
Merge bra ‘devel' O07b8d7d 
Ty originidevel upyate gitignore 0D1a564d 
preparing for deletion of tasks De98155 
feature Complete ed2787a 
task fixtures for database clicc7cc 
new feature: tasks from database fb2c72d 
prettier styling 4aeb273 





能 支行 使 用 专用 的 分 支 


进行 错误 修复 

















图 12-1 在 Git 中 使 用 多 个 分 支 进行 开发 和 错误 修复 


12.1.2 ”功能 测试 : Velocity 框架 


合并 到 主 分 支 的 所 有 代码 都 应 该 经 过 充分 的 测试 ,在 代码 上 做 标签 使 跟踪 测试 的 候选 集合 更 
容易 ， 特 别 是 当 应 用 的 测试 人 员 不 是 开发 人 员 时 。 

测试 有 各 种 形式 的 , 包括 : 单元 测试 一 一 对 应 用 的 一 小 部 分 进行 隔离 测试 ; 集成 测试 一 一 确 
保 所 有 的 组 件 能 够 一 起 工作 ; 以 及 专注 于 用 户 的 行为 驱动 测试 ( behavior-driven test，BDT， 也 被 





称 为 验收 测试 ，acceptance 


test )。 近 年 来 ,JavaScript 应 用 的 几 个 测试 工具 已 经 覆盖 所 有 这 些 领 域 。 





除了 Tinytest 以 外 "，Meteor 使 用 这 些 你 可 能 从 其 他 项 目 中 已 经 知道 的 测试 工具 : Jasmine 、Mocha、 
结合 Seleni um 使 用 的 Robot 框 保 ， 以 及 Cucumber。 


表 12-1 中 列 出 了 测试 和 











匡 架 的 概述 和 它们 的 应 用 领域 ， 也 列 出 了 在 Meteor 中 使 用 它们 的 包 名 。 


这 些 框架 中 的 每 一 个 都 有 相当 丰富 的 文档 , 所 以 我 们 不 会 讨论 它们 的 使 用 方法 , 但 会 向 你 展示 如 


何 将 它们 整合 到 Meteor 项 
http://velocity.meteor.com, 





下 面 的 表格 中 也 提 到 了 Tinytest， 表 明 Tinytest 也 可 以 用 于 Meteor 的 测试 ， 此 处 原文 的 表述 不 其 准确 。 一 一 译 者 注 


目 中 。 为 了 更 好 地 了 解 这 些 工具 如 何 工 作 ， 你 可 以 访问 Velocity 页 面 
或 看 看 每 个 项 目的 文档 。 
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表 12-1 Meteor 功 能 测试 工具 概述 





框架 包 的 名 字 单元 测试 _ 集成 测试 验收 测试 
Tinytest tinytest 服务 器 、 客户 端 (只 用 于 Isopack) 一 
Jasmine sanjo:jasmine 服务 器 客户 端 二 
Mocha mike:mocha as 服务 器 、 客户 端 ” 一 
Robot Framework rsbatech:robotframework 一 客户 端 
Cucumber Xolvio:cucumber 客户 端 











Meteor 的 官方 测试 框架 称 为 Velocity。 从 技术 上 说 ， 它 是 一 个 测试 运行 者 ， 包 括 特定 的 测试 
框架 。Velocity 由 Meteor 社 区 的 一 个 团队 开发 ， 它 可 让 你 使 用 任何 已 建立 的 测试 库 组 合 来 定义 自 
动 化 测试 ”。 

Velocity 框 架 是 通过 包 添 加 的 ， 它 甚至 直接 集成 在 应 用 的 用 户 界面 中 。 每 当 你 在 应 用 中 添加 
一 个 表 12-1 中 的 测试 框架 时 ， 也 就 添加 了 Velocity。 要 使 用 Jasmine， 可 使 用 以 下 的 命令 : 

$ meteor add sanjo:jasmine 

所 有 的 框架 都 包含 一 个 显示 测试 结果 的 HTML 报 告 。 除了 Jasmine 以 外 ,所 有 的 框架 中 都 默认 
添加 了 这 个 报告 。 要 为 Jasmine 显 式 添 加 报告 ， 使 用 这 个 命令 : 

$ meteor add velocity:html-reporter 

现在 运行 neteor 时 将 在 页 面 右上 角 显示 一 个 绿色 的 点 。 这 就 是 HTML 报 告 ， 你 可 以 通过 单 
击 这 个 点 来 访问 报告 , 如 图 12-2 所 示 。 报告 展示 了 所 有 已 安装 Velocity 测试 框架 的 测试 结果 。 如 果 
还 没有 定义 测试 ，Jasmine 包 允许 你 创建 一 组 样本 测试 。 一 旦 一 个 测试 可 用 ， 这 个 视图 将 显示 每 
个 测试 的 结果 (成功 或 失败 )。 如 果 测 试 结果 变化 ， 它 将 进行 响应 式 更 新 。 每 次 保存 代码 时 ， 集 
成 测试 和 单元 测试 通常 会 重新 运行 ， 这 样 可 获得 代码 是 否 通过 测试 的 实时 反馈 。 


单 击 绿色 的 点 将 进入 
Velocity 的 HTML 报 告 ”VEL@CITY 


Todo List @ 1 6 
Type to add new tasks PASS 
more 


Noming row | 16 tests passed in 87 s 


Make awesome app available on mobile 
















































































六 


lasmlne-server-integration 


Player should be able to play a Song 1 ms 








Player 


Player tells the current song if the user has made it a favorite 1 ms 














图 12-2 ”Velocity 有 个 HTML 报告 ， 其 中 有 覆盖 了 实际 应 用 的 一 个 完整 测试 报告 

















Q@ 如 果 你 计划 定期 对 生产 环境 进行 更 新 ,就 值得 建立 一 个 连续 集成 ( continuous integration ,CI ) 或 连续 交付 ( continuous 
delivery，CD ) 的 环境 ， 在 其 中 可 一 键 执行 所 有 的 测试 并 可 以 选择 是 否 部 署 到 目标 系统 。 如 果 你 想 开 始 利用 CI 环 
境 带 来 的 好 处 ， 可 以 看 看 Travis 或 Jenkins。 
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所 有 的 测试 都 放 在 Meteor 应 用 根 目 录 中 一 个 叫 作 测 试 ( tests ) 的 文件 夹 中 。 在 运行 puilad 或 
使 用 --production 参 数 运行 服务 器 的 时 候 ， 它 们 不 会 被 添加 到 应 用 。 这 意味 着 在 部 署 应 用 之 前 
你 不 必 删 除 测试 。 

虽然 你 应 该 有 单元 测试 , 但 它们 不 确保 用 户 能 够 正确 无 误 地 执行 应 用 中 的 所 有 操作 。 在 测试 
应 用 时 不 要 忘记 包括 负面 测试 , 用 于 测试 用 户 意 想 不 到 的 动作 ， 比 如 在 一 个 只 接受 数字 的 字段 中 
输入 了 字母 。 使 用 70/20/10 规 则 ?进行 测试 : 70% 的 单元 测试 ，20% 的 集成 测试 ，10% 的 验收 测试 
或 点 到 点 的 测试 。 














提示 除非 你 有 特殊 的 理由 使 用 Mocha 或 Robot 框 架 , 使 用 Jasmine 和 Cucumber 可 以 履 盖 测试 的 所 
有 领域 。 

















在 一 天 结束 时 ,测试 代码 和 问题 跟踪 都 和 透明 度 相关 。 你 需要 知道 应 用 是 否 已 经 可 以 发 布 。 
如 果 还 有 没有 修复 的 问题 ， 你 需要 决定 它们 是 否 会 阻止 你 的 应 用 进入 生产 或 它们 是 否 可 以 接受 。 
只 有 经 过 充分 测试 和 没有 任何 错误 会 阻碍 它 进 入 生产 的 代码 ， 才 应 该 被 标记 为 可 部 署 的 。 


12.1.3 ”估算 和 测试 负载 


如 果 你 还 没有 考虑 过 应 用 用 户 的 预期 数量 , 那 现在 是 时 候 来 考虑 了 。 当 然 ， 从 功能 上 说 ， 你 
对 应 用 的 用 户 有 很 好 的 理解 ， 但 现在 你 必须 专注 于 规模 。 考 虑 下 面 三 个 问题 。 
口 你 有 多 少 (并 发 ) 用 户 ? 
口 单个 用 户 生成 多 少数 据 (和 负载 ) ? 
口 你 的 用 户 在 哪里 ? 

1. 最 坏 的 、 最 好 的 和 实际 的 情况 

虽然 可 能 很 难 估计 用 户 的 确切 数量 , 但 你 至 少 可 以 为 第 一 个 月 的 用 户 数量 给 出 一 些 合理 的 数 
字 。 估 计 网 站 访问 者 的 一 个 常用 方法 是 假设 三 种 情况 : 最 好 的 情况 、 最 坏 的 情况 和 实际 的 情况 。 
在 最 好 的 情况 下 ， 你 的 营销 活动 非常 成 功 ， 用 户 数 达 到 了 你 期 望 的 最 大 值 。 你 不 应 该 考虑 
slashdotting”， 除 非 它 是 你 的 明确 目标 。 最 坏 的 情况 下 只 有 最 少 的 人 访问 你 的 网 站 。 而 实际 的 情 
况 是 介 于 这 二 者 之 间 。 如 果 你 已 经 有 一 个 类 似 的 Web 存 在 ,就 可 以 使 用 现 有 的 服务 器 日 志 作为 评 
估 的 起 点 。 

为 了 说 明 如 何 估 计 用 户 数量 ,让 我 们 考虑 一 个 在 线 游戏 ， 即 几 个 用 户 互 相 玩 的 拼 字 游戏 。 我 
们 最 坏 的 情况 预计 每 天 100 个 用 户 ( 3000/ 月 )， 实 际 的 情况 为 每 天 1000 个 用 户 (30 000/ 月 )， 最 好 
的 情况 可 能 每 天 10 000 个 用 户 ( 300 000/ 月 )。 

这 些 数字 告诉 你 什么 呢 ?” 起 初 , 你 会 用 它们 来 计算 可 能 的 存储 需求 。 如 果 每 个 用 户 都 可 以 上 






















































































GD 看 看 谷歌 测试 博客 的 这 篇 文章 : http://googletesting.blogspot.de/2015/04/just-say-no-to-more-end-to-end-tests.html。 
@ Slashdot 效 应 ,也 称 为 slashdotting， 其 发 生 情况 为 在 一 个 受 欢迎 的 网 站 中 添加 一 个 小 网 站 的 链接 ， 导致 小 网 站 流量 
的 大 幅 增 加 。 可 参考 http://en.wikipedia.org/wiki/Slashdot_effect。 




















248 第 12 章 开始 生产 





传 一 个 头像 , 你 希望 保存 他 们 玩 的 每 个 游戏 的 详细 统计 数据 , 以 及 他 们 在 游戏 中 使 用 的 每 个 单词 ， 
那么 你 可 以 1MB 作 为 每 个 用 户 的 基准 。 这 就 是 说 ， 你 的 应 用 需要 3 到 300GB 的 存储 ( 见 下 表 )。 


表 12-2 ”一 个 部 署 的 用 户 估计 


























最 坏 的 情况 实际 的 情况 最 好 的 情况 
用 户 / 月 3000 30 000 300 000 
用 户 /天 100 1000 10 000 
存储 /用 户 1MB 1MB 1MB 
整体 的 存储 要 求 3GB 30GB 300GB 
除非 计算 并 发 用 户 的 数量 , 否则 当 涉 及 负载 或 内 存 时 ,你 将 无 法 找到 任何 合理 的 服务 器 需求 。 
做 一 个 假设 , 然后 使 用 简单 的 数学 计算 , 你 可 以 确定 一 个 并 发 用 户 数 ， 而 它 是 设计 服务 器 设置 的 


一 个 重要 数字 。 

2. 估算 并 发 用 户 

要 确定 所 需 的 资源 ， 你 需要 更 多 地 了 解 用 户 行为 。 数 字 本 身 并 没有 告诉 你 ,所 有 的 用 户 是 均 
匀 分 布 的 还 是 他 们 只 活跃 在 每 个 星期 六 的 晚上 。 但 这 些 信息 是 重要 的 ， 如 果 可 以 事先 知道 它们 ， 
你 也 必须 在 部 署 中 做 出 相关 设计 以 处 理 任 何 尖峰 负载 。 

你 的 拼 字 游戏 是 一 个 休闲 游戏 , 所 以 你 期 望 用 户主 要 在 非 工 作 时 间 上 线 。 这 意味 着 在 上 午 12 
点 和 下 午 1 点 之 间 有 更 多 的 流量 ( 在 午休 时 间 玩 一 个 简单 的 游戏 )， 另 一 个 时 间 是 下 午 6 点 到 晚上 
11 点 。 这 样 大 部 分 游戏 在 这 六 个 小 时 的 时 间 窗 口中 进行 。 因 为 你 仍然 在 估计 ， 所 以 可 以 安全 地 忽 
略 这 个 窗口 外 的 所 有 时 间 ， 假 设 所 有 的 用 户 都 处 于 这 段 时 间 中 。 

对 于 并 发 用 户 的 数量 ， 你 必须 再 做 一 个 假设 : 用 户 游戏 花费 的 平均 时 间 。 

在 最 坏 的 情况 下 , 你 有 100 个 用 户 , 他 们 分 布 在 六 小 时 内 。 从 beta 测 试 中 你 知道 , 玩家 通常 花 
10 分 钟 玩 游戏 ,平均 每 个 游戏 有 四 名 玩家 参与 。 六 小 时 即 360 分 钟 。 你 将 使 用 这 个 数字 来 计算 最 
大 并 发 性 ， 方 法 是 用 时 间 窗 口内 的 用 户 数 除 以 时 间 窗 口内 游戏 的 持续 时 间 : 
并 发 用 户 = 期 望 用 户 数 / ( 时 间 窗 口 /平均 游戏 长 度 ) 
现在 你 知道 你 的 服务 右 应 该 能 够 处 理 3 个 、28 个 或 278 个 并 发 用 户 , 这 将 取决 于 场景 ( 表 12-3 )。 


表 12-3 ”计算 并 发 用 户 









































































































































最 坏 的 情况 现实 的 情况 最 好 的 情况 
用 户 100 1000 10 000 
时 间 窗 (分 钟 ) 360 360 360 
平均 每 个 游戏 的 参与 人 数 4 4 4 
平均 游戏 长 度 (分 钟 ) 10 10 10 
并 发 游戏 (四舍五入 ) 1 7 70 
并 发 用 户 (四舍五入) 3 28 278 




















下 一 步 是 进行 负载 测试 ， 以 计算 服务 于 这 么 多 并 发 用 户 所 需 的 服务 器 资源 。 
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3. 负载 测试 

负载 测试 是 一 个 复杂 的 任务 ， 尤 其 是 像 Meteor 这 样 把 一 些 处 理 外 包 给 客户 端的 时 候 。 生 成 
HTTP 负 载 的 工具 传统 ， 如 Apache Bench (ab ) 或 Siege 不 能 用 来 可 靠 地 测试 JavaScript 应 用 。 

解决 的 办 法 是 使 用 负载 模拟 来 生成 客户 端 发 送 的 DDP 消 息 或 直接 模拟 客户 端 ， 比 如 使 用 
PhantomJS 。Meteor 的 第 一 个 负载 测试 工具 是 meteor-loadq-test ( https://github.com/alanning/ 
meteor-load-test )， 它 通过 发 送 DDP 消 息 来 对 应 用 进行 压力 测试 。 它 灵活 地 将 Java 的 负载 测试 工具 
Grinder 用 于 测试 API。meteor-down ( https://github.com/meteorhacks/meteor-down ) 是 另 一 个 可 
用 的 工具 ， 它 允许 你 写 出 可 以 直接 订阅 Meteor 发 布 和 执行 Meteor 方 法 的 Node.js 应 用 。 

联合 使 用 PhantomJS 和 CasperJS 的 例子 是 meteor-parties-stresstest(https:/github.comy/ 
yauh/meteor-parties-stresstest )。 负 载 测试 最 重要 的 部 分 是 监控 的 结果 以 及 知道 如 何 解释 它们 。 

作为 负载 测试 的 结果 ， 你 可 以 了 解 一 些 应 用 的 重要 信息 。 它 会 清晰 地 说 明 可 能 存在 的 瓶颈 ， 
以 及 你 的 服务 器 是 否 需 要 更 大 的 CPU 或 更 多 的 内 存 。 这 个 主题 很 快 就 会 变 得 可 以 压倒 一 切 ， 而 进 
行 负载 测试 的 一 个 简单 方式 是 找到 对 应 用 进行 缩放 的 方法 。 

试 着 确定 你 的 应 用 是 否 可 以 以 线性 方式 进行 缩放 。 让 五 个 用 户 同时 运行 你 的 应 用 , 看 看 有 多 
少 服务 器 CPU 和 内 存 被 消耗 。 然 后 增加 五 个 用 户 ， 并 再 次 检查 。 做 这 个 测试 至 少 两 次 以 上 ,你 拥 
有 的 数据 越 多 ， 你 的 预测 将 越 准确 。 增 加 用 户 的 数量 ， 直 到 达到 被 测试 机 器 的 最 大 内 存 或 CPU。 

最 终 ， 你 应 该 有 10 个 、20 个 、50 个 或 更 多 并 发 用 户 的 数据 。 然 后 ， 你 可 以 绘制 一 个 简单 的 图 
表 显 示 服 务 需 在 负载 下 的 行为 。 这 将 告诉 你 服务 需 的 哪个 方面 需要 加 强 ， 以 及 成 本 预期 是 多 少 。 

4. 位 置 

最 后 , 你 应 该 考虑 用 户 所 在 的 位 置 。 如 果 你 的 应 用 用 户 群 来 自 一 小 块 地 理 区 域 , 那么 你 应 该 
注意 不 要 把 主机 部 署 在 千里 之 外 。 减少 网 络 传输 时 间 仍 然 是 提高 用 户 体验 的 一 个 重要 因素 ,所 以 
请 确保 你 的 服务 器 接近 你 的 用 户 。 

如 果 你 的 用 户 来 自 世 界 各 地 , 你 应 该 看 看 那些 支持 在 不 同 地 理 位 置 放置 多 台 服 务 器 的 托管 方 
式 。 男 外 ， 内 容 分 发 网 络 可 以 帮助 减少 网 络 流 量 。 

































































































































































提示 网 络 延 迟 是 影响 用 户 体验 的 一 个 巨大 因素 。 请 确保 不 仅 要 使 用 足够 强大 的 服务 器 ， 也 要 
将 它们 放 在 尽 可 能 靠近 用 户 的 地 方 。 


12.1.4 ”服务 器 管理 


大 多 数 软件 开发 人 员 对 运行 和 管理 服务 器 不 感 兴趣 ， 虽 然 他 们 不 应 该 这 样 。 值 得 庆幸 的 是 ， 
你 不 必 是 一 个 服务 器 专家 ， 有 许多 平台 即 服务 ( Platform-as-a-Service，PaagS ) 的 产品 ， 你 可 以 租 
一 个 Meteor 或 Mongo 的 实例 ， 而 不 需要 管理 自己 的 服务 器 。 然 后 你 需要 充分 了 解 整体 的 架构 ， 以 
估计 运行 应 用 时 所 需要 的 工作 量 和 相关 成 本 。 
如 果 你 没有 选择 一 个 全 方位 服务 的 Paas 供 应 商 , 那么 你 必须 决定 谁 来 管理 应 用 服务 器 、 监 控 《| 
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负荷 和 可 能 出 现 的 故障 、 进 行 安全 更 新 以 及 更 新 SSL 证 书 。 云 提供 商 往 往 会 处 理 这 些 事情 ,但 你 
必须 为 这 些 服务 付费 。 

备份 

当 你 的 服务 器 朋 演 、 所 有 的 数据 都 丢失 了 , 会 发 生 什么 事情 ?应 用 的 源码 在 版 本 控制 系统 中 
是 安全 的 , 但 是 , 除非 你 有 一 些 备份 策略 , 不 然 所 有 用 户 贡 献 的 数据 就 丢失 了 。 在 Meteor 项 目 中 ， 
通常 有 两 种 类 型 的 数据 需要 备份 。 
口 MongoDB 数 据 库 
口 上 传 的 文件 
MongoDB 的 备份 是 相当 简单 的 。 你 可 以 创建 一 个 副本 集 ， 异 地 运行 男 一 个 MongoDB 实 例 来 
实现 完美 的 即时 备份 。 或 者 ， 你 可 执行 传统 的 备份 。 在 一 个 典型 的 MongoDB 备 份 中 ， 你 可 以 使 
用 mongodump 和 mongorestore 备 份 和 恢复 数据 库 。 

备份 文件 与 其 他 的 Web 项 目 没什么 不 同 。 只 是 要 确保 备份 中 包括 了 所 有 相关 的 配置 文件 ， 如 
果 它 们 不 在 版 本 控制 中 (它们 应 该 在 ! )。 如 果 你 的 主机 不 带 备份 解决 方案 ,最 好 是 创建 自己 的 滚 
动 备份 ， 例 如 使 用 rsnapshot ( http:/www.rsnapshot.org/ )。 你 要 意识 到 ， 即 使 云 服 务 商 声称 云 是 安 
全 的 ,他们 也 可 能 会 失去 数据 ， 有 自己 的 备份 总 是 更 安全 , 尤其 是 当 你 不 能 承受 丢失 重要 客户 数 
据 的 时 候 。 运 行 RAID-1 驱 动 器 不 能 代替 定期 ( 每 天 或 至 少 每 周一 次 ) 的 备份 。 


































































































12.1.5 ”清单 


你 可 以 使 用 下 面 这 个 简单 的 清单 以 确保 你 准备 好 进入 生产 状态 。 你 应 该 能 够 用 “是 ”回答 下 
面 所 有 的 问题 。 

(1) 你 是 否 使 用 了 版 本 控制 系统 管理 代码 ? 

(2) 你 的 软件 没有 什么 问题 会 阻止 应 用 上 线 吗 ? 

(3) 你 知道 预期 有 多 少 用 户 ( 含 并 发 ) 吗 ? 

(4) 你 是 否 进 行 过 负载 测试 以 确定 单个 用 户 需 要 多 少 的 CPU/ 内 存 ? 

(5) 你 计算 了 所 需 磁 盘 空 间 的 大 小 吗 ? 

(6) 你 知道 你 的 用 户 在 哪里 吗 ? 

(7) 用 户 只 通过 数据 库 交换 数据 吗 ? 如果 不 是 , 你 有 计划 确保 服务 器 实例 之 间 流 量 的 安全 吗 ? 

(8) 你 有 专门 的 、 训 练 有 素 的 工作 人 员 来 管理 服务 器 吗 ? 

(9) 你 有 计划 一 个 备份 策略 吗 ? 

(10) 你 测试 过 你 的 备份 策略 并 成 功 执行 过 一 次 恢复 吗 ? 


12.2 ”安装 和 部 署 


现在 是 时 候 把 你 的 应 用 放 在 一 个 在 线 的 服务 右上 了 。 根 据 应 用 的 关键 程度 和 期 望 的 用 户 数 ， 
你 可 以 在 三 个 主要 的 部 署 选 项 中 进行 选择 。 为 了 帮助 你 作出 这 个 决定 ， 表 12-4 列 出 了 每 个 选项 的 
优点 和 缺点 。 
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表 12-4 ”Meteor 服 务 器 选项 的 优点 和 缺点 












































部 署 目标 优 点 缺 ”点 
meteor.com 部 署 最 简单 ， 没 有 托管 成 本 没有 可 用 性 保证 , 没有 自 定 
义 的 网 址 
云 服务 提供 商 (如 Modulus、Heroku 或 ” 低 管 理 开销 , 快速 和 容易 的 可 扩展 性 , 为 每 ”有 限 的 配置 选项 控制 
Nodejitsu) 个 实际 使 用 付费 
手动 设置 (如 亚马逊 EC2、Rackspace 或 自 ”充分 的 灵活 性 , 在 不 同 应 用 中 重用 现 有 资源 ”需要 管理 知识 , 缩放 需要 更 
己 的 硬件 ) 的 能 多 的 时 间 








对 构建 快速 原型 而 言 ， 使 用 meteorcom 基 础 设施 是 最 简单 的 方法 ， 但 它 不 是 用 于 生产 的 好 选 
择 ， 因 为 它 没有 向 你 保证 可 用 性 ， 缩 放 也 很 复杂 。 你 的 应 用 可 能 在 某 些 时 间 不 在 线 或 没有 响应 。 
另 一 方面 ， 它 是 一 个 免费 的 选择 ， 所 以 你 可 能 会 在 某 些 情 况 下 使 用 它 。 

如 果 你 不 想 花 大 量 的 时 间 在 系统 管理 上 , 选择 一 个 现 有 的 云 提供 商 可 能 是 个 很 好 的 做 法 。 除 
了 不 需要 进行 系统 配置 ,他 们 经 常 还 提供 了 一 键 式 缩放 ， 人 允许 你 几乎 在 瞬间 添加 更 多 的 实例 。 请 
记 住 , 你 将 无 法 控制 底层 基础 设施 的 所 有 设置 ， 因为 它 通常 是 在 多 个 应 用 中 共享 的 。 对 于 一 些 非 
常规 的 可 能 实现 的 要 求 ， 你 可 能 需要 付出 非常 高 昂 的 价格 。 

如 果 你 熟悉 管理 服务 器 ， 并 有 专门 的 人 可 以 在 短 时 间 内 修复 问题 ， 手 动 设置 将 是 最 灵活 的 。 
如 果 你 正在 主持 多 个 项 目 ， 它 可 以 成 为 最 好 的 选择 ， 即 使 不 需要 外 来 的 配置 。 此 时 ， 你 将 不 得 不 
更 多 地 考虑 所 需 的 资源 ， 因 为 你 为 整个 方案 付费 ， 而 不 仅仅 为 你 的 使 用 付费 。 添 加 更 多 的 实例 相 
比 于 一 键 设置 也 需要 更 多 的 时 间 。 

























































































12.2.1 最 简单 的 部 署 : meteor.com 


要 部 署 到 meteor.com， 需 要 Meteor 的 CLI 工 具 。 当 你 的 应 用 准备 好 以 后 ， 下 面 的 命令 将 会 把 
它 发 送 到 meteor.com 的 基础 设施 : 


$ meteor deploy <subdomain> 


将 <subdomain> 改 为 用 于 访问 你 应 用 的 子 域名 。meteor.com 使 用 开发 者 账号 确保 一 旦 你 的 应 
用 部 署 到 一 个 免费 的 子 域名 ， 没 有 人 能 够 覆盖 它 。 子 域名 和 你 的 meteorcom 开 发 者 账户 联系 在 一 
起 。 如 果 你 还 没有 开发 者 账户 这 通常 是 第 一 次 部 署 的 情况 , 你 将 在 部 署 过 程 中 被 要 求 自 动 设 
置 一 个 。 你 需要 做 的 是 提供 你 的 电子 邮件 地 址 , 然后 设置 一 个 meteor.com 网 站 的 用 户 名 和 密码 ( 参 
见 图 12-3 )。 
如 果 有 多 个 开发 人 员 都 需要 能 够 部 署 到 一 个 meteorcom 子 域 ， 可 以 将 他 们 添加 到 一 个 组 织 。 
该 组 织 的 每 个 成 员 将 在 项 目 中 具有 相同 的 权限 。 

































































说 明 如 果 你 需要 调试 一 个 已 部 署 的 应 用 ， 可 以 使 用 meteor deploy <subdomain> --debug， 
这 将 允许 你 使 用 基于 浏览 器 的 调试 器 ， 你 的 断 点 将 会 被 保持 。 
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Set up your account 
Time to pick a username and a password for your Meteor developer account. 


You can use this account to manage the sites that you deploy with meteor deploy and to log into sites across 


the Meteor community. 


Username 


myyssermame 


Password 


= 





CREATE ACCOUNT 











图 12-3 ”设置 你 的 Meteor 开 发 者 账户 


当 你 尝试 部 署 到 现 有 子 域 ，meteor deploy 将 提示 你 输入 用 户 名 和 密码 以 进行 身份 验证 。 
一 旦 你 成 功 地 通过 身份 验证 ，Meteor 会 在 本 地 系统 中 记 住 你 的 账户 。 这 样 ， 你 不 需要 为 后 续 的 部 
署 登录 , 即使 它们 是 与 你 当前 登录 账户 相关 联 的 其 他 网 站 。 你 可 以 使 用 下 面 的 命令 来 查看 你 被 授 
权 的 所 有 子 域 列表 : 


$ meteor list-sites 


要 管理 meteorcom 基 础 设施 上 的 一 个 应 用 ， 你 可 以 使 用 命令 行 工具 来 访问 服务 器 的 日 志文 件 
(参见 图 12-4 ) 甚至 是 数据 库 外 壳 。 








@e@Oe@ 大 myApp 一 bash — 110x25 


MacBookPro:myApp stephanS meteor deploy mysampleappon 
To instantly deploy your app on a free testing server, just enter your 
email address! 





Email: mail@meteorinaction.com 

Deploying to http://mysampleappon.meteor.com. 

Now serving at http://mysampleappon.meteor.com 

You can set a password on your account or change your email address at: 
https://www.meteor.com/setPassword?5CwrvpAfMag 


MacBookPro:myApp stephanS meteor logs mysampleappon 

[Tue Nov 94 2814 13:36:11 GHT+0069 (UTC)] INFO STATUS null -> starting 

[Tue Nov 894 2914 13:36:11 GHT+0066 (UTC)] NOTICE Starting application on port 13188 

[Tue Nov 94 26914 13:36:11 GHT+69069 (UTC)] INF0 STATUS starting -> running 

[Tue Nov 94 2614 13:49:31 GHT+60066 (UTC)] INFO HIT / 91.52.215.18 

[Tue Nov 864 2014 13:40:32 GMT+68066 (UTC)] INFO HIT /26ae2c8d51b2567244e598844414ecdec2615ce3.cs5 91.52.215.18 
[Tue Nov 94 2914 13:49:32 GMT+8888 (UTC)] INF0 HIT /819f96ffbb57aa2351efdbf57c2ea8b6cb8e89bd.js 91.52.215.18 
[Tue Nov 84 2914 13:40:33 GMT+9066 (UTC)] INF0 HIT /favicon.ico 91.52.215.18 

[Tue Nov 84 2914 13:40:47 GMT+69099 (UTC)] INFO HIT / 91.52.215.18 

[Tue Nov 894 2914 13:46:47 GMT+0888 (UTC)] INF0 HIT /20ae2c8d51b2587244e598844414ecdec2615ce3.css 91.52.215.18 
[Tue Nov 94 2914 13:49:47 GMT+8888 (UTC)] INF0 HIT /819f96ffbb57aa2351efdbf57c2ea8b6cb9e89bd.js 91.52.215.18 
[Tue Nov 84 2814 13:48:48 GMT+8888 (UTC)] INF0 HIT /favicon.ico 91.52.215.18 

[Tue Nov 84 2914 13:41:86 GMT+6966 (UTC)] INFO HIT /_GALAXY_ 91.52.215.18 

MacBookPro:myApp stephan$ | | 











图 12-4 ”从 命令 行 部 署 和 访问 日 志 
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这 可 用 下 面 的 命令 来 实现 : 


$ meteor logs <subdomain> 





和 


$ meteor mongo <subdomain> 


说 明 虽然 使 用 meteorcom 基 础 设施 很 方便 ， 但 它 还 不 适合 生产 级 部 署 。 


获得 meteorcom 中 的 MongoDB 连 接 字 符 串 

假设 你 部 署 了 一 个 应 用 到 meteor.com,，, 与 其 他 用 户 一 起 进行 测试 , 并 且 获 得 了 巨大 的 成 功 。 
现在 你 想 将 数据 迁移 到 一 个 专用 的 数据 库 ， 但 你 不 知道 如 何 访问 远程 的 数据 库 。 

当 你 为 meteor mongo 指 定 --url 参 数 时 , 其 返回 值 是 一 个 MongoDB 的 连接 字符 串 , 例如 : 


$ meteor mongo --url mysubdqomainname .meteor .com 
mongodb://client-b4898462:4f69301a-8be4-7196-a2db-23816e785e9e@ 
字 production-db-a2.meteor.io:27017/mysampleappon_ meteor_com 


这 个 URL 可 以 用 在 任何 MongoDB 客 户 端 中 ， 比 如 Robomongo， 也 可 以 传递 给 mongodump 
命令 用 于 访问 和 提取 数据 。 然 而 ,这 个 网 址 在 一 分 钟 后 就 过 期 了 ， 所 以 你 需要 迅速 使 用 它 ， 否 
则 用 户 名 和 密码 将 被 拒绝 。 因 此 ， 通 过 电子 邮件 与 他 人 共享 这 个 连接 字符 串 是 没有 用 的 。 


12.2.2 无 所 不 包 的 主机 : 云 供应 商 


虽然 Meteor 专 用 的 托管 主机 还 没有 被 广泛 使 用 , 但 是 已 经 有 很 多 运行 Node.js 应 用 的 平台 。 
为 Meteor 应 用 可 以 迅速 转换 为 可 运行 在 普通 Node.js 服 务 器 上 的 应 用 , 所 以 你 可 以 使 用 任何 能 够 托 
管 Node.js 应 用 的 供应 商 。 

如 果 你 正在 使 用 一 个 云 提供 商 的 基础 设施 ( 表 12-5 中 有 一 个 简短 的 列表 )， 就 没有 必要 自己 
设置 任何 组 件 和 流程 。 通 常 ， 供 应 商 也 将 在 他 们 的 服务 组 合 中 提供 MongoDB， 这 将 允许 你 托管 


一 个 公司 的 所 有 组 件 。 






































表 12-5 ”Node.js 服 务 〈Node.js-as-a-Service) 提供 商 





供应 商 URL 
Modulus https://modulus.io/ 
Heroku http://www.heroku.com/ 
Nodejitsu http://www.nodejitsu.com/ 


要 使 Meteor 应 用 在 Nodejs 提 供 商 的 系统 上 运行 , 你 的 应 用 需要 为 部 署 过 程 做 些 准备 。 这 个 准 
备 取 决 于 你 选择 的 供应 商 ， 有 的 可 以 直接 托管 一 个 Meteor 的 应 用 , 但 他 们 中 的 大 多 数 需要 你 首先 | 














254 第 12 章 开始 生产 





把 项 目 转换 为 一 个 普通 的 Node.js 应 用 。 
1. 使 用 demeteorizer 制 作 高 度 可 移植 的 Node.js 包 





demeteorizer 项 目 是 由 Modulus 云 供应 商 背 后 的 工程 师 发 起 的 ,demeteorizer 通 过 创 于 





个 标准 的 Node.js 应 用 ， 封 装 和 扩展 了 buil1d 命 令 。 





要 用 demeteorizer 创 建 高 度 可 移植 的 Node.js 包 , 你 首先 需要 在 开发 系统 中 安 

















是 以 node 模 块 的 形式 存在 的 ， 所 以 可 以 通过 npm 来 安装 : 


$ npm install -9 demeteorizer 





| 


一 旦 demeteorizer 安 装 完成 ， 它 的 工作 原理 类 似 于 第 11 章 介绍 的 bui1lgd 命 令 。 进 入 项 目的 


根 文件 来， 从 命令 行 调用 它 : 


$ cd myMeteorProject 
$ demeteorizer -t myApp.tar.gz 






































和 bui1g 命 令 不 同 的 是 ，demeteorizer 默 认 创建 一 个 目录 ,这 就 是 需要 -t 选 项 来 创建 一 个 
压缩 文件 的 原因 。 默 认 情 况 下 ， 它 会 创建 一 个 新 的 目录 名 .demeteorized， 在 这 个 目录 中 ， 它 创建 


的 结构 如 图 12-5 所 示 。 


Oe@e® 恩 .demeteorized 
| MacBookPro: .demeteorized stephan$ ls -1L 
total 32 


-r--r--r-- 1 stephan staff 543 4 Nov 15:09 README 
-r--r--r-- 1 stephan staff 485 4 Nov 15:09 main.js 
-rw-r--r-- 1 stephan staff 2182 4 Nov 15:09 package.json 
drwxr-xr-x 4 stephan staff 136 4 Nov 15:09 programs 
drwxr-xr-x 3 stephan staff 162 4 Nov 15:09 server 
-r--r--r-- 1 stephan staff 1137 4 Nov 15:09 star.json 
MacBookPro: .demeteorized stephan$ tree -d -L 4 
programs 
server 
app 
assets 
LL packages 
npm 
ddp 
logging 
minifiers 
mongo 
webapp 
packages 
web.browser 
server 


14 directories 
MacBookPro: .demeteorized stephans 目 














图 12-5 aqemeteorizer 生 成 的 目录 结 梳 





Meteor build 和 demeteorizer 之 间 的 差异 


这 两 个 命令 都 会 创建 一 个 Node.js 应 用 ,但 是 其 中 有 一 个 细微 但 重要 的 差异 。meteor 
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build 创 建 一 个 应 用 ,其 中 包括 nom 模块 。demeteorizer 不 会 捆绑 任何 mpm 模 块 ， 但 是 它 包 
含 一 个 元 数据 文件 (packages.json )， 其 中 指定 了 运行 应 用 需要 的 npm 模 块 。 














O00 国 bundle 全 国生 天 demeteorized 
< 2 围 四 ol 可 《 3 围 m 四 ,ol 票 关 -》 
No 
ne package.json ee 
®] main.js in bundle 3 main.js 
Y programs 一 加 package.json 
了 轩 server 了 | programs 
» Ml app v Ml server 
» Ml assets » ll app 
© boot-utils.js » 天 assets 
boot.js | boot-utils.js 
国 config.json boot,js 
©) mini-files.js a 转 config.json 
v npm i mini-files.js 
7 国 ddp in demeteorizer 7 npm 
p | node_modules vv ddp 
> BD email > BQ email 
> BD iron_router > BN iron_router 
» Ml logging » Ml logging 
>» PY meteor > Nl meteor 
* Ml mongo » Ml mongo 
> npm-bcrypt > BD npm-bcrypt 
>» Nl webapp » 天 webapp 
图 npm-shrinkwrap.json 园 packagejson 
国 package.json » Nl packages 
上 MM packages 国 programJjson 
图 program.json 齐 ] shell-server.js 
二 ] shell-serverjs p 出 web.browser 
> ON web.browser FE ON web.cordova 
上 上 web.cordova README 
README pb ON server 
» Ml server 转 starjson 
图 starjson 


大 多 数 提供 Node.js 应 用 托管 的 供应 商 需要 package.json 文 件 ， 它 们 使 用 npm instal1 来 安 
装 npm 模 块 ， 而 不 是 在 应 用 中 包含 这 些 模块 。 因 此 ， 部 署 应 用 到 普通 的 Node.js 服 务 商 需要 使 用 


demeteorizero。 


得 到 的 归档 文件 可 以 上 传 和 解压 到 服务 器 上 ,一 些 供应 商 , 如 Modulus.io 允 许 你 直接 通过 Web 














接口 上 传 文件 。 由 于 在 项 目的 根 目录 有 package.json 文 件 的 存在 , 如 果 你 的 提供 商 支 持 , 所 有 node 
模块 将 会 自动 安装 ， 不 然 你 需要 进入 到 部 署 服务 器 上 项 目的 根 文件 夹 ， 发 出 以 下 的 安装 命令 : 


$ cd /var/www/myDemeteorizedApp 


$ npm install 











现在 你 的 应 用 开始 运行 了 , 你 可 以 设置 数据 库 。 因 为 确切 的 步 又 因 不 同 的 供应 商 而 有 所 不 同 ， 
所 以 我 们 不 会 在 这 里 详细 介绍 它 。 你 可 以 在 应 用 中 使 用 任何 喜欢 的 MongoDB 实 例 ， 它 甚至 不 需 


要 托管 在 同一 个 供应 商 。 
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2. MongoDB 服 务 

有 时 需要 分 别 托管 Meteor 和 MongoDB。Node.js 提 供 商 可 能 不 提供 某 些 你 想 要 使 用 的 
MongoDB 功 能 (比如 最 新 操作 日 志 ， 即 oplogtailing )， 或 者 和 竞争 对 手 比 起 来 他 们 太 昂 贵 。 在 这 
种 情况 下 ， 有 很 多 MongoDB 服 务 ( MongoDB-as-a-Service ) 提供 商 (参见 表 12-6 ) 可 能 适合 你 。 
其 中 一 些 可 以 从 一 个 完全 免费 的 计划 开始 , 这 使 他 们 成 为 小 项 目的 理想 起 点 , 你 可 以 在 后 期 很 容 
易 地 通过 一 键 缩放 你 的 项 目 。 


表 12-6 ”MongoDB 服 务 (MongoDB-as-a-Service) 提供 者 

















供 应 商 URL 
MongoLab https://mongolab.com/ 
Compose.io http://www.compose.io/ 
MongoSoup http://www.mongosoup.de/en/ 
ObjectRocket http://www.objectrocket.com/ 
Elastx http://elastx.com/ 


3. 优点 

你 不 需要 知道 很 多 关于 MongoDB 及 其 内 部 结构 的 知识 ， 所 以 使 用 供应 商 服务 会 让 你 快速 地 
启动 。 管理 的 开销 最 小 ,你 获得 了 高 可 用 性 和 负载 均衡 的 所 有 功能 , 所 以 你 可 以 专注 于 你 的 应 用 。 
此 外 ， 切 换 到 下 一 个 更 大 的 数据 库 也 是 很 容易 的 。 

通常 情况 下 , 专门 的 数据 库 供 应 商 那 里 一 些 不 常用 的 功能 会 比较 便宜 , 有 些 对 于 低 流量 的 网 
站 甚至 有 免费 的 服务 可 用 。 

4. 缺点 

你 的 应 用 服务 器 和 MongoDB 实 例 之 间 的 网 络 延迟 将 远 远 高 于 在 应 用 服务 器 边 上 托管 自己 的 
数据 库 。 但 由 于 许多 供应 商 使 用 亚马逊 、Rackspace 公 司 的 基础 设施 ， 如 果 你 在 自己 的 服务 器 上 
也 使 用 相同 的 基础 设施 ， 可 能 没有 明显 的 效果 。 

不 用 管理 基础 设施 是 舒适 的 , 但 你 需要 付费 , 特别 是 当 你 的 需求 超越 了 价格 清单 上 可 用 的 大 
小 时 。 为 获得 最 佳 性 能 ， 你 需要 在 Meteor 应 用 中 包括 最 新 操作 日 志 , 但 一 些 供应 商会 为 此 收取 高 
额 的 费用 ， 因 为 它 需 要 一 个 专门 的 副本 集 ， 他 们 不 能 为 你 的 数据 使 用 一 个 共享 的 分 片 。 


12.2.3 ”最 灵活 的 方式 : 手动 设置 


在 服务 器 上 手动 设置 Meteor 是 很 简单 的 。 如 果 你 的 服务 器 上 正在 运行 Ubuntu 、Debian 或 
OpenSolaris , meteor -up 使 这 一 点 变 得 更 加 容易 , meteor-up 也 被 称 为 nup。 如 果 你 不 能 使 用 mup 
或 需要 更 大 的 灵活 性 , 要 在 自己 的 服务 右上 运行 项 目 , 你 就 需要 一 个 普通 的 Nodejs 服 务 器 以 及 上 
一 节 中 讨论 过 的 一 些 需 要 的 功能 。 

meteor-up 

meteor-up 是 一 个 社区 项 目 。 该 工具 可 以 让 你 设置 服务 器 、 部 署 Meteor。 首 先 ， 你 初始 化 一 
个 新 的 项 目 、 配 置 环境 、 启 动 服务 安装 并 最 终 部 署 你 的 项 目 。 更 多 的 信息 可 以 参考 GitHub: 
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https://github.com/arunoda/meteor-upo 
通过 npm 安 装 meteor-up: 


$ npm install -9 mup 





使 用 终端 进入 到 你 的 Meteor 应 用 目录 ， 并 用 此 命令 初始 化 一 个 新 项 目 : 
$ mup init 


现在 ， 在 当前 目录 中 有 两 个 JSON 文 件 。 
口 mup.json 一 一 此 文件 用 于 定义 作为 部 署 目标 的 服务 右 并 指定 要 安装 哪些 组 件 。 


口 settings.json 一 一 些 文件 用 来 定义 meteor.settings 中 部 署 相关 的 配置 选项 。 比 如 可 用 于 API 
密 钥 或 服务 器 凭据 。 


虽然 你 可 以 不 使 用 settings.json， 但 必须 调整 mup.json 的 内 容 以 反映 自己 的 服务 器 设置 。 在 这 
个 示例 中 ， 你 将 使 用 两 个 主机 ( 代码 清单 12-1 )， 但 不 想 在 其 中 的 任何 一 个 上 建立 MongoDB。 











代码 清单 12-1 mup.json 配 置 


{ 
// 服务 器 认证 信息 你 可 以 定义 一 个 或 多 


"servers": | 个 用 于 部 署 的 服务 器 
{ 


"host": "hostl.meteorinaction.com", 

"username": "stephan", 

//"password": "password" a 

// pem 文 件 优先 (基于 ssh 认 证 ) 可 用 于 认证 的 SSH 


"pem" : "~/.ssh/id_rsa" 密 钥 或 密码 














"host": "host2.meteorinaction.com", 
"username": "stephan", 
"pem": "~/.ssh/iqd_rsa" 

} 
J 
// 在 服务 器 上 安装 MongoDB, 在 以 后 设置 中 不 破坏 本 地 MongoDB 
"setupMongo": true, < mup 也 可 以 设置 一 个 没 

有 分 片 复制 的 MongoDB 

// 警告 : 需要 安装 Node .js 
// 只 有 服务 器 上 已 安装 Node .js 时 才 可 跳 过 此 步 


"setupNode": true, 








// 警告 : 如 果 nodeVersion 被 忽略 了 ， 就 会 默认 设置 为 0.10.36 
// 不 用 v， 只 用 版 本 号 


"nodeVersion": "0.10.36", 





PhantomJS 不 是 必需 
,但 它 和 其 他 一 些 
// 在 服务 器 上 安装 PhantomJs A 他 一 些 包 
"setupPhantom": true, 
// 应 用 名 称 (无 空格 ) 如 果 你 将 多 个 Meteor 实 例 部 
Ce 署 到 同一 台 机 器 上 ， 可 以 使 


用 不 同 的 名 称 来 区 分 它们 
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// 应 用 的 位 置 (本 地 目录 ) a :a 
"app": "/Users/stephan/Code/meteorinaction", 本 地 机 器 上 而 不 是 服务 器 
上 的 应 用 源码 路 径 

// 配置 环境 
用 外 部 "env": { 用 于 此 应 用 的 
MongoDB "ROOT_URL": "http://www.meteorinaction.com" 环境 变量 
时 ， 在 环境 "PORT": "3000" 
变量 中 定义 "MONGO_URL": "mongodb://user:password@192.168.2.210/meteor" 
连接 字符 串 ; "MONGO_OPLOG_URL": "mongodb://oploguser:password@192.168.2.210/ 指定 Meteor 
若 使 用 了 操 > local?authSource=admin" 使 用 的 端口 ， 
作 日 志 , 也 | }， 这 是 可 选 的 
必须 声明 

// Meter UP 在 mup 进 行 查看 之 前 检查 应 用 是 否 在 部 署 之 后 成 功 上 线 ， 它 将 等 待 的 秒 数 配 置 如 下 





和 二 


"deployCheckWaitTime": 15 
查看 部 署 是 否 成 功 


需要 等 待 的 秒 数 
正如 你 在 代码 清单 12-1 中 看 到 的 设置 ，mup 将 部 署 到 服务 器 hostl.meteorinaction.com 和 





host2.meteorinaction.com， 使 用 用 户 "stephan" 的 SSH 密 钥 。 出 于 安全 原因 ， 你 应 该 避免 使 用 密 


码 ， 





而 应 该 依靠 更 安全 的 SSH 密 钥 "。 


说 明 虽然 使 用 密码 来 测试 部 署 是 很 诱 人 的 ， 但 应 该 考虑 使 用 SSH 密 钥 而 不 是 密码 进行 生产 部 署 。 


在 这 个 例子 中 ， 你 将 设置 MongoDB 2.6 和 Node.js 0.10.36。 你 也 会 安装 PhantomJS ， 它 用 于 


spidqerable 这 样 的 包 以 提高 搜索 引擎 的 可 见 性 。 应 用 名 称 用 于 识别 服务 器 上 的 node 进 程 。 你 可 


以 使 
可 用 


三 居 
里 ， 


用 mup 在 同一 台 机 器 上 部 署 多 个 node 进 程 ， 每 个 进程 使 用 不 同 的 mup.json 配 置 ， 而 应 用 名 称 
于 区 分 这 些 进程 。 应 用 的 位 置 和 要 从 本 地 工作 站 或 笔记 本 电脑 部 署 的 项 目 相 关 。 使 用 环境 变 
可 以 微调 Meteor 运 行 时 环境 。 

如 果 有 一 个 多 核 服 务 器 ,你 可 能 想 在 同一 台 机 器 上 部 署 多 个 Meteor 实 例 , 使 所 有 的 核心 都 派 




















上 用 场 ,在 这 种 情况 下 , 你 需要 为 每 个 实例 使 用 不 同 的 应 用 名 称 和 端口 , 而 这 又 需要 多 个 mupjson 











文件 。 为 了 避免 冲突 ,请 为 每 个 核心 使 用 一 个 专用 的 目录 。 对 于 一 个 双核 系统 ， 其 结构 可 能 看 起 
来 像 这 样 : 
让 client 
六 一 corel 
— mup.json 
六 一 core2 
— mup.json 
六 一 public 
六 -一 server 





— settings .json 
































Q@ SSH 密 钥 可 用 于 Linux 、Mac OS X 和 Windows。 要 了 解 更 多 关于 使 用 密 钥 的 内 容 ， 可 参考 https:/help.ubuntu. 


com/community/SSH/OpenSSH/Keys。 
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两 个 mup.json 文 件 的 内 容 应 该 一 模 一 样 ， 只 有 应 用 的 名 称 和 PORT 环 境 变 量 是 不 同 的 。 

如 果 没 有 本 地 的 MongoDB 实 例 ， 你 需要 用 环境 变量 来 指定 数据 库 的 URL。 如 果 使 用 操作 日 
志 (oplog )， 你 也 可 以 在 其 中 定义 数据 库 URL。 

一 旦 配置 完成 ， 你 可 以 使 用 以 下 命令 来 设置 环境 : 

$ mup setup 

这 将 为 你 处 理 所 有 的 服务 器 配置 和 安装 。meteor up 还 确保 所 有 的 服务 器 进程 在 机 器 开启 后 
就 启动 。 此 外 ， 如 果 node 朋 江 ， 它 将 使 用 forever 重 启 node。 它 现在 还 没有 将 你 的 应 用 复制 到 
服务 器 上 。 

打包 和 部 署 应 用 是 最 后 一 步 ( 参见 图 12-6 )。 


$ mup deploy 

















@e@e@ 轩 | app 
MacBook:app stephan$ mup deploy 


Meteor Up: Production Quality Meteor Deployments 


” Checkout Kadiral 
It's the best way to monitor performance of your app. 


Visit: https://kadira.io/mup ” 
Building Started: /Users/stephan/code/github/meteor-benchapp/app 


Started TaskList: Deploy app 'meteor' (Linux) 


[192.168.2.71] - Uploading bundle 

[192.168.2.71] ~ Uploading bundle: SUCCESS 

[192.168.2.71] - Setting up Environment Variables 
[192.168.2.71] ~ Setting up Environment Variables: SUCCESS 
[192.168.2.71] - Invoking deployment process 
[192.168.2.71] ~ Invoking deployment process: SUCCESS 


Completed TaskList: Deploy app 'meteor' (Linux) 
MacBook:app stephans 目 














图 12-6 ”使 用 Meteor Up 设置 服务 器 


除了 init 和 aeploy 以 外 ， 还 有 其 他 启动 和 停止 应 用 的 命令 ( start/stop/restart ) 和 访 
问 Node.js 日 志 (1ogs ) 的 命令 。 当 为 1ogs 指 定 -f 选 项 后 ， 可 以 连续 监视 日 志文 件 ， 类 似 于 使 用 
tail -f 命 令 。 


12.3 将 各 部 分 连接 起 来 


运行 一 个 应 用 服务 咒 时 ， 你 可 以 配置 很 多 东西 。 你 可 能 需要 更 改 服 务 需 监听 的 端口 、 定 义 根 
URL, 或 者 在 其 中 包含 到 数据 库 服务 器 或 邮件 服务 器 的 详细 连接 信息 。 在 服务 器 启动 时 所 需要 的 
所 有 设置 都 是 以 环境 变量 的 形式 传递 给 Meteor 的 。 
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12.3.1 ”环境 变量 


根据 应 用 所 使 用 的 包 , 你 可 以 设置 环境 变量 来 影响 Meteor 应 用 的 行为 方式 。 最 常见 的 环境 变 
量 列 在 表 12-7 中 。 









































变 量 名 描述 
PORT 绑 定 的 网 络 端口 (默认: 3000) 
BIND_IP 绑 定 的 卫 地 址 (默认 : 所 有 ) 
ROOT_URL 应 用 的 根 URL 
MONGO_URL MongoDB 连 接 字 符 串 
MONGO_OPLOG_URL MongoDB 操 作 日 志 连 接 字 符 串 
MAIL_URL 邮件 服务 器 发 送 邮 件 (SMTP) 的 连接 字符 串 (上 默认: STDOUT) 
NODE_ENV 一 些 云 供应 商 使 用 这 个 ， 通 常设 置 为 production 














大 多 数 云 提 供 商 都 有 Web 界 面 用 于 定义 环境 变量 的 名 称 和 值 ( 参见 图 12-7 )。 


© O 9 /wodulus |Nodejs & Mong x \ 





€ > [@ https:/ /modulus.io/project/00000/admin - ] 四 








ENVIRONMENT VARIABLES 

Environment variables provide a way for you to define globally accessible varlables inside 
your application. Typically these are used for things like differentiating between your 
production or staging environment, database connection strings, or any data you do not 


want in your code. 
process.env.NODE_ENV // "production' 
NODE_ENV production 
ROOT_URL http:/meteorinaction.comy 


MONGO_OPLOG_URL mongodb://usermame:password@mongoserver.org;10435/local?authSource=mete 


~ 
< 
口 
< 
加 
[a] 
[rm 
[rs 


HAVE 


MONGO_URL mongodbyusername-passwordGDmongoserver .org:10435fmeteor 
MAIL_URL smtpV/lstephan%40meteorinaction corrpasswordGlsmtp gmal.com:587 
Name Value 


Any changes made to environment variables will not be reflected until you re-deploy or 
restart your project. Variable names cannot start with numbers and can only contain alpha- 
numeric characters and underscores. 


SAVE 





图 12-7 ”在 Modulus 中 定义 环境 变量 


12.3.2 ”Meteor 和 MongoDB 的 连接 


一 且 Node,js 服 务 器 和 MongoDB 服 务 器 实例 开始 运行 ， 你 就 可 以 配置 Meteor 让 它 知 道 如 何 访 
问 数 据 库 。 你 可 以 使 用 变量 MONGO_URL 和 MONGO_OPLOG_URI 分 别 指定 对 普通 数据 库 和 操作 日 志 
的 访问 。 两 者 都 使 用 相同 的 标准 MongoDB 连 接 字符 串 语法 : 
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mongodb://<username>:<password>@<host>/<database>?<options> 
D mongodb:// 是 所 需 的 前 级 ， 表 示 这 是 标准 格式 的 连接 字符 串 。 
口 username:password@ 是 可 选 的 。 如 果 存 在 ,它们 将 用 于 登录 特定 的 数据 库 。 

口 nost 是 唯一 必需 的 部 分 。 如 果 没 有 指定 端口 ， 将 默认 使 用 27017。 你 可 以 定义 多 个 主机 ， 
用 逗号 分 隔 。 

D /aatabase 需要 和 username:password 一 起 使 用 ， 用 于 指定 在 成 功 连接 到 服务 器 后 要 
登录 的 数据 库 。 如 果 没 有 指定 ， 默 认 使 用 adamin 数 据 库 。 

口 options 是 连接 选项 ， 其 格式 为 name=value 对 ， 使 用 & 分 隔 。 

让 我 们 假设 有 表 12-8 中 所 描述 的 环境 。 


表 12-8 MongoDB 连 接 信息 示例 



























































关 键 字 值 
MongoDB 服 务 器 地 址 mongo.local.lan 
数据 库 名 称 meteordb 
数据 库 用 户 meteoruser 
数据 库 密码 drowssap 
操作 日 志 用 户 oploguser 
操作 日 志 密 码 drowssap 





基于 这 些 值 ， 连 接 字符 串 看 起 来 将 像 这 样 : 


$ export MONGO_URL=mongodb://meteoruser:drowssap@mongo.local.lan/meteordb 
$ export MONGO_OPLOG URL=mongodb://oploguser:drowssap@mongo.1local.lan/ 
local?authSource=admin 


注意 ， 你 在 MONGO_URL 中 指定 Meteor 要 使 用 的 数据 库 ， 即 meteorgdb。 与 之 相反 的 是 ， 应 用 
数据 库 的 名 称 与 MONGO_OPLOG_URL 无 关 ， 它 总 是 使 用 1ocal。 这 是 因为 操作 日 志 存放 在 local 
数据 库 中 。 因 为 用 户 无 法 通过 local 数 据 库 验证 ， 所 以 你 需要 在 连接 字符 串 中 传递 另 一 个 选项 
authSource， 这 将 使 用 adqmin 数 据 库 作为 身份 验证 源 。 


12.4 扩展 策略 


系统 体系 结构 和 编写 软件 一 样 复 杂 。 本 节 将 向 你 介绍 可 扩展 性 的 主要 概念 , 但 不 会 讨论 过 多 
的 细节 。 可 扩展 性 有 两 个 不 同 的 方面 。 
口 可 靠 性 (reliability ): 单个 组 件 的 故障 不 会 导致 系统 月 演 。 
口 可 用 性 ( availability ): 每 一 个 请 求 都 可 以 被 处 理 。 

乍 一 看 , 两 者 似乎 是 一 样 的 , 但 它们 服务 于 完全 不 同 的 目的 。 这 两 个 方面 都 可 以 译 成 高 可 用 
性 (high availability，HA )， 但 可 靠 性 侧重 于 宛 余 的 组 件 ， 而 可 用 性 往往 通过 负载 平衡 达到 。 
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12.4.1 使 用 元 余 的 主动 一 被 动 高 可 用 性 


当 应 用 在 生产 环境 中 运行 时 ， 你 期 望 它 每 周 7 天 每 天 24 小 时 可 用 。 按 应 用 的 性 质 不 同 ， 当 应 
用 不 可 用 时 你 将 开始 失去 用 户 其 至 金钱 。 这 就 是 大 多 数 生产 部 署 架构 要 求 是 高 度 可 用 的 原因 。 它 
归根 到 底 就 是 要 求 你 的 设置 没有 任何 单 点 的 失败 。 每 个 组 件 都 可 能 会 在 某 个 时 间 点 上 不 可 用 , 但 
这 不 应 该 对 用 户 有 任何 显著 的 影响 。 即 使 没有 管理 员 立 刻 进行 修复 , 操作 也 应 该 能 够 继续 。 这 种 
方法 不 仅 有 助 于 部 分 组 件 失 败 的 情况 ， 而 且 还 可 以 在 整个 系统 不 下 线 的 情况 下 定期 进行 系统 更 
新 。 图 12-8 说 明了 实现 高 可 用 应 用 所 需 的 步 又 。 

































































第 一 步 ， 第 二 步 : 第 三 步 ， 
单个 实例 高 可 用 数据 库 一 直 在 线 
户 用 户 











图 12-8 ”从 单一 实例 到 高 可 用 性 


在 HA 环境 中 你 经 常 能 找到 主动 一 被 动 的 组 合 : 一 个 服务 器 做 实际 的 工作 , 另 一 个 处 在 空闲 的 
状态 , 它 随时 准备 在 第 一 台 服 务 顺 宕 机 之 后 接管 它 的 工作 。 如 果 你 发 现 自己 用 尽 了 服务 顺 的 最 大 
资源 ， 这 意味 着 单一 服务 器 不 能 处 理 所 有 的 请 求 ， 你 需要 垂直 缩放 〈 也 称 为 放大 ，scaling up )， 
即 你 需要 添加 更 多 的 服务 器 资源 ， 如 CPU 或 内 存 。 如 果 在 Amazon EC2 上 运行 ， 你 就 需要 升级 服 
务 器 , 从 一 个 中 等 的 实例 升级 到 一 个 大 的 实例 。 但 你 不 能 永远 垂直 扩展 , 如 果 你 的 应 用 非常 成 功 ， 
你 会 达到 一 个 点 ， 即 没有 一 个 单一 的 服务 器 能 够 独立 处 理 所 有 的 负载 。 

使 用 负载 平衡 的 主动 一 主动 高 可 用 性 

如 果 在 同一 时 间 只 有 一 个 实例 可 以 工作 , 它 不 会 给 你 什么 真实 的 选择 来 处 理 更 多 的 负载 。 用 
一 个 更 大 的 服务 需 来 蔡 换 小 的 服务 需 通 常 需要 时 间 , 这 就 是 你 也 应 该 考虑 水 平 缩放 ( 扩大 , scaling 
out ) 的 原因 。 

在 负载 均衡 的 环境 中 ， 服 务 器 以 主动 一 主动 方式 成 对 运行 ， 这 意味 着 两 个 服务 器 都 积极 地 获 
取 和 处 理 请 求 。 不幸 的 是 , 如 果 一 个 主动 服务 咒 的 处 理会 影响 另 一 台 服 务 器 上 当前 正在 使 用 的 数 
据 或 过 程 , 管理 依赖 关系 将 变 得 更 为 复杂 。 在 本 章 前 面 介绍 的 拼 字 游戏 应 用 中 ,你 需要 考虑 两 个 
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不 同 服务 器 上 的 玩家 怎样 才能 够 玩 同一 个 游戏 。 





12.4.2 ” 单 组件 部 署 


当 你 在 本 地 运行 Meteor 时 , 有 一 个 Meteor 应 用 和 一 个 MongoDB 实 例 。 这 提供 了 一 个 相当 简单 
的 设置 , 其 优势 是 不 会 在 多 个 机 器 之 间 共 享 任何 会 话 数据 或 用 户 。 它 也 为 开发 环境 做 了 一 个 理想 
的 设置 ,你 知道 在 哪里 可 以 查看 日 志文 件 、 定 位 潜在 的 错误 , 也 没有 必要 先 分 析 错 误 可 能 发 生 在 
哪 台 服务 器 上 或 者 是 否 有 什么 负载 均衡 组 件 导致 了 它们 自己 的 错误 。 

单 实例 的 缺点 是 ， 这 种 结构 不 安全 、 不 能 缩放 。 如 果 你 的 MongoDB 宕 了 ， 整 个 应 用 将 无 法 
正常 工作 。 对 于 Meteor 服 务 器 也 是 这 样 。 此 外 ， 随 着 用 户 数 (并 发 数 ) 的 增加 ， 你 只 有 一 个 真正 
的 缩放 解决 方案 : 购买 一 个 更 大 的 服务 器 。 


12.4.3 ”元 余 和 负载 均衡 


对 于 更 好 的 可 扩展 性 和 高 可 用 性 ,其 第 一 步 是 确保 数据 库 总 是 可 用 的 。 如 果 你 使 用 PaaS 提 供 
商 的 数据 库 ， 他 们 会 确保 你 总 是 可 以 访问 你 的 数据 。 如 果 你 需要 建立 自己 的 高 可 用 数据 库 ， 或 者 
如 果 你 想 知 道 更 多 关于 MongoDB 集 群 的 运行 原理 ， 可 参考 附录 B。 

实现 高 可 用 性 的 第 二 个 步骤 是 确保 应 用 本 身 始终 是 可 以 访问 的 。 这 就 需要 扩展 Meteor 服 务 
絮 。 因 为 Meteor 的 应 用 服务 器 是 Node.js 服 务 器 ,所 以 所 有 用 于 托管 Node.js 的 原则 也 适用 于 Meteor。 
根据 用 户 的 预期 数量 ， 你 应 该 设置 两 个 或 多 个 服务 器 实例 。 因 为 你 不 能 要 求 用 户 访 问 服务 器 1 或 
服务 器 2， 所 以 你 可 以 添加 一 个 自动 调度 和 负载 均衡 ,将 到 单个 URL 的 所 有 请 求 分 配 到 所 有 的 应 
用 服务 器 上 。 

1. 负载 均衡 

在 负载 均衡 之 后 运行 Web 应 用 是 一 种 常见 的 最 佳 实践 。 有 很 多 现存 的 工具 可 用 ,比如 HAProxy 
或 nginx 这 样 的 开源 软件 ,以 及 F5 或 思科 产 的 专用 硬件 盒子 .其 原理 和 MongoDB 的 查询 路 由 相同 ”: 
一 定数 量 的 实际 工作 进程 (或 应 用 ) 作为 一 个 逻辑 组 运行 ,所 有 客户 端的 请 求 都 被 发 送 到 这 些 工 
作 进程 中 的 某 一 个 。 

Meteor 不 同 于 传统 的 网 页 服务 方式 。 在 传统 的 方法 中 ， 连 接 是 无 状态 的 。 在 一 系列 请 求 中 ， 
哪个 应 用 服务 器 响应 哪个 请 求 没有 任何 区 别 。 然 而 ， 在 Meteor 中 ， 每 个 连接 都 会 维护 一 个 状态 ， 
因此 如 果 来 自 同 一 客户 端的 不 同 请 求 在 服务 器 之 间 进 行 切换 将 会 导致 操作 的 失败 , 因为 关于 上 下 
文 的 所 有 信息 都 丢失 了 。 无 论 你 选择 实现 哪个 负载 均衡 方法 ,都 必须 确保 客户 端 不 在 服务 器 之 间 
切换 ， 除 非 你 有 一 种 在 所 有 节点 ?之 间 交 换 状 态 信息 的 方法 。 

让 用 户 留 在 同一 人 台 服 务 器 最 简单 的 形式 是 在 负载 均衡 中 记 住 他 ,比如 说 将 应 用 服务 器 和 IP 地 
址 联系 起 来 。 从 IP 192.168.2.201 来 的 所 有 请 求 都 会 去 服务 器 A， 无 论 其 当前 负荷 是 多 少 。 另 外 ， 

























































































































































































中 关于 MongoDB 查 询 路 由 器 的 更 多 信息 可 查看 附录 B。 
@) 即 服务 器 。 一 一 译 者 注 
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负载 均衡 可 以 设 定 一 个 cookie 来 记 住 某 个 客户 端 应 该 去 哪个 服务 器 。 

2. 常用 的 负载 均衡 算法 

了 解 分 配 请 求 的 重要 算法 将 有 助 于 你 为 应 用 作出 最 佳 选 择 。 许 多 人 都 很 熟悉 轮转 (round 
robin )， 这 意味 着 所 有 的 请 求 都 被 均匀 地 分 配 到 服务 器 : 请 求 1 到 服务 器 A， 请求 2 到 服务 器 B， 请 
求 3 再 到 服务 器 A， 请求 4 到 B， 如 此 等 等 。 如 果 你 的 服务 器 都 有 相同 的 规格 ,这 是 个 很 好 的 选择 ， 
但 如 果 其 中 一 个 更 强大 ， 加 权 轮 转 ( weighted round robin ) 可 能 是 更 好 的 选择 。 你 可 能 会 在 配置 
中 让 服务 器 A 获取 原 有 两 倍 的 请 求 ， 因 为 它 具 有 双 倍 的 内 存 和 处 理 器 。 

不 幸 的 是 , 这 些 算法 没有 考虑 一 个 服务 器 当前 可 能 的 负载 ， 比 如 它们 不 知道 用 户 已 经 结束 了 
他 们 的 会 话 。 一 个 典型 的 负载 均衡 不 知道 一 个 请 求 重 定 向 目标 节点 的 状态 。 有 些 算法 可 以 确定 服 
务 器 需要 多 和 久 才 能 响应 , 并 避免 将 更 多 的 用 户 发 送 到 已 经 没有 响应 的 服务 器 上 。 负载 均衡 可 以 配 
置 为 基于 实际 的 连接 数 来 分 发 用 户 。 这 就 是 最 少 连 接 ( least connection ) 算法 ,负载 均衡 主动 检 
查 一 个 服务 器 上 当前 有 多 少 用 户 连 接 ， 并 基于 此 均匀 地 分 发 用 户 。 

所 有 的 算法 都 有 自己 的 具体 用 途 。 如 果 有 疑问 ， 最 好 的 办 法 是 从 轮转 开始 ， 启 用 会 话 业 性。 
附录 C 中 有 一 些 配 置 的 实例 可 供 参 考 。 

3. 单线 程 

为 帮助 你 避免 处 理 多 线程 体系 结构 的 复杂 性 ，Node.js 设 计 为 在 单线 程 中 运行 。 这 意味 着 无 
论 有 多 少 核 心 存在 ， 它 只 会 运行 在 一 个 核心 的 一 个 线程 中 。 这 是 放大 应 用 的 一 个 主要 障碍 ， 如 
果 你 的 应 用 变 慢 ， 你 不 能 简单 地 用 一 个 有 更 多 CPU 的 大 机 器 来 解决 问题 ， 你 必须 进行 水 平 放 大 。 
虽然 已 经 有 一 个 Node.js 集 群 包 , 但 它 还 不 能 用 于 生产 "。 如 果 有 一 个 多 核 服 务 器 ,你 可 以 在 同一 
个 服务 器 上 运行 多 个 Meteor 进 程 以 利用 所 有 的 核心 。 使 用 不 同 的 端口 ， 负 载 均衡 能 够 将 请 求 分 
布 在 同一 机 器 中 的 多 个 实例 上 ， 就 像 不 同 的 物理 服务 器 一 样 。 通 常 操 作 系 统 会 在 不 同 的 核心 上 
运行 不 同 的 进程 ， 但 如 果 你 想 直 接 控 制 Meteor 实 例 运 行 在 哪个 核心 上 ， 可 以 在 Linux 上 使 用 
taskset 包 。 





























































































































提示 在 同一 人 台 服 务 器 上 运行 多 个 Meteor 实 例 将 允许 你 使 用 多 个 CPU, 但 它 不 会 提供 真正 的 高 可 
用 性 ， 除 非 你 使 用 两 个 或 多 个 独立 的 服务 器 。 


4. 安全 的 连接 : SSL 

虽然 Nodejs 支 持 SSL 连 接 ， 但 Meteor 本 身 并 不 支持 。 要 提供 安全 的 连接 ，SSL 仍 然 可 以 在 面 
向 客户 的 负载 均衡 中 使 用 。 负 和 载 均衡 和 应 用 服务 器 之 间 的 所 有 通信 将 是 未 加 密 的 ， 这 被 称 为 SSL 
印 载 ( SSL offloading )。 用 户 和 数据 中 心 之 间 的 所 有 信息 将 仍然 是 完全 安全 的 ， 但 是 在 数据 中 心 
内 部 ， 你 需要 信任 基础 设施 的 提供 商 。 

在 跨 数据 中 心 的 负载 均衡 中 需要 小 心 。 如 果 负 载 均衡 位 于 美国 ， 但 它 将 请 求 重 定向 到 日 本 
Meteor 服 务 器 ， 它 一 定 不 能 在 美国 终止 SSL， 而 应 该 将 这 个 SSL 请 求 重 定向 到 日 本 ， 并 使 用 本 地 
























































g 在 写 这 一 章 的 时 候 ，Nodejs 集 群 包 的 稳定 性 被 标记 为 : 1- 实 验 阶段 。 
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的 负载 均衡 卸载 SSL。 和 否则 ， 用 户 可 能 会 看 到 一 个 HTTPS 连 接 ， 但 事实 上 它 像 其 他 未 加 密 的 请 求 
一 样 跨越 了 半 个 世界 。 

在 许多 环境 中 nginx 用 于 SSL 御 载 ， 因 此 它 保护 了 Meteor 应 用 ， 使 Meteor 不 需要 关心 相关 的 基 
础 设施 问题 ， 而 只 需 关 注 一 个 目的 : 运行 应 用 。 

5. 会 话 状态 

回 到 我 们 的 拼 字 游戏 , 我 们 假设 四 个 玩家 登录 两 个 经 过 负载 均衡 的 服务 器 。 现 在 两 个 玩家 在 
服务 器 A 上 ， 另外 两 个 在 服务 器 B 上 ， 但 他 们 都 应 该 加 入 同一 个 游戏 。 在 所 有 实例 之 间 共 享 信息 
最 简单 的 方法 是 使 用 数据 库 作 为 信息 交换 的 中 心 。 虽然 从 应 用 的 角度 来 看 , 它 可 能 看 起 来 像 一 个 
理想 的 方法 , 但 它 给 数据 库 服务 器 增加 了 大 量 的 负载 , 需要 许多 磁盘 读 写 操 作 ， 这 可 能 最 终 在 用 
户 那里 导致 明显 的 滞后 。 毕 竞 ,持久 化 短暂 的 数据 是 不 合理 的 ， 比 如 对 手 鼠 标 指 针 的 位 置 ， 或 者 
他 们 是 否 正在 打字 等 。 

在 应 用 服务 器 之 间 进 行 数据 交换 ， 较 好 的 解决 方案 是 使 用 Redis 一 一 一 个 内 存 中 的 数据 库 。 
本 质 上 ，Redis 是 一 个 简单 的 键 值 存储 。 它 类 似 于 MongoDB, 它 文 持 分 片 ， 并 且 提 供 了 一 种 手段 ， 
可 在 主 进程 不 可 用 时 转移 到 另 一 个 服务 器 。 关 键 的 区 别 是 ,所 有 的 数据 都 保存 在 内 存 中 , 这 使 它 
避免 了 所 有 的 磁盘 IO 操作 ， 因 而 Redis 是 存储 所 有 会 话 相 关 数 据 的 快速 和 有 效 的 方式 。 

6. 代理 服务 器 

虽然 从 技术 上 说 , 这 不 是 高 可 用 性 的 一 部 分 , 但 引入 代理 服务 器 是 提高 性 能 并 最 终 使 你 的 应 
用 以 较 少 资源 运行 的 一 个 好 方法 。 

对 提供 动态 内 容 服 务 而 言 , Nodejs 是 伟大 的 , 但 它 对 于 静态 文件 却 没有 同样 的 效果 。 所 有 对 
全 部 用 户 都 相同 的 资源 应 该 由 代理 服务 器 提供 服务 。 它 们 包括 图 像 文件 、 字 体 ,， 理想 的 情况 下 也 
包括 CSS 和 JavaScript 文 件 。 如 果 要 求 不 是 太 高 , 负载 均衡 和 静态 内 容 服务 可 以 通过 单个 进程 实现 ， 
比如 nginx。 


12.4.4 绝对 可 用 性 


相 比 之 下 , 设计 一 个 99% 可 用 的 系统 是 相对 容易 的 。 这 意味 着 一 年 中 有 3.65 天 或 一 个 月 超过 7 
个 小 时 ， 你 的 应 用 可 以 离线 。 从 两 个 9 到 五 个 9 ( 这 意味 着 从 99% 到 99.999% ) 将 把 应 用 的 不 可 用 
性 降低 到 一 年 不 到 5.5 分 钟 。 实 现 最 后 的 1%， 其 费用 是 以 指数 增长 的 并 且 很 少 值得 努力 ， 除 非 你 
的 应 用 对 健康 或 业务 至 关 重 要 。 

在 系统 体系 结构 中 ,概率 是 所 有 决策 的 一 个 驱动 因素 。 高 度 可 用 的 组 件 越 多 ,整个 系统 宕 机 
的 可 能 性 就 越 小 。 当 然 ， 网 络 路 由 器 也 可 能 会 失败 。 限 电 可 能 会 发 生 ， 甚 至 整个 数据 中 心 都 曾经 
被 淹没 。 如 果 你 绝对 不 能 容忍 任何 系统 中 断 ， 那么 你 应 该 确保 你 的 服务 器 在 不 同 的 数据 中 心 , 并 
且 所 有 电缆 都 有 宛 余 的 连接 。 然 而 ， 对 大 多 数 用 例 而 言 ， 关 注 服务 器 进程 并 将 基础 设施 留 给 你 的 
提供 商 就 足够 了 。 
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12.5 总结 


在 这 一 章 中 ,你 已 经 了 解 到 以 下 内 容 。 

口 使 用 版 本 控制 并 用 一 个 专门 的 分 支管 理 生 产 状态 的 代码 。 

口 使 用 Velocity 框架 重用 已 有 的 JavaScript 测 试 框架 。 

D 作出 假设 以 估计 预期 的 负载 ， 并 确定 所 需 的 架构 。 

口 决定 是 使 用 PaaS 提 供 商 还 是 建立 自己 的 基础 设施 。 

口 使 用 环境 变量 来 确定 应 用 服务 器 需要 连接 的 组 件 。 

口 认识 到 99% 的 可 用 性 是 比较 容易 的 ， 但 要 超越 这 个 数字 需要 作出 很 多 努力 。 






























































安装 Meteor 








本 附录 内 容 
口 安装 Meteor 的 先决 条 件 
口 如 何在 开发 机 右上 安装 Meteor 




















在 本 附录 中 ， 我 们 将 强调 安装 Meteor 的 先决 条 件 并 和 你 一 起 一 步 步 地 安装 它 。 除 非 是 在 
Windows 上 ， 否 则 你 可 以 用 单个 命令 来 启动 Meteor。 我 们 将 涵盖 所 有 主要 的 平台 。 


A.1 先决 条 件 


和 许多 其 他 的 Web 开 发 工具 不 同 ，Meteor 是 一 个 独立 的 安装 ， 不 需要 什么 特定 软件 的 存在 。 
安装 程序 将 把 Node.js 和 MongoDB 放 在 你 的 home 目 录 ， 因 此 它们 不 会 与 prew 或 apt -get 等 包 管 
理 需 安装 的 其 他 实例 冲突 。 为 了 确保 一 个 能 完全 工作 的 环境 ，Meteor 将 始终 使 用 它 安装 的 二 进 
制 文 件 。 

目前 支持 的 平台 包括 以 下 几 个 。 

口 Max OS X 10.7 及 以 后 的 版 本 
口 Windows 7、Windows 8.1、Windows 服 务 器 2008 和 Windows 服 务 器 2012 
口 Linux (x86 和 x86 _64 系 统 ) 

BSD 和 其 他 操作 系统 不 支持 。 利 用 虚拟 化 技术 ， 比 如 通过 运行 Vagrant 盒 子 ( 我们 将 在 稍 后 讨 
论 Vagrant )， 也 可 以 在 不 支持 的 系统 上 安装 Meteor 并 进行 开发 。 

如 果 你 不 能 安装 Meteor 或 更 喜欢 在 云 上 运行 它 ， 可 以 使 用 Nitrous ( http://nitrous.io/ )。 它 提供 
了 云 上 的 IDE， 不 需要 在 本 地 进行 安装 。 


























A.2 在 Linux 和 MacOS X 上 安装 Meteor 


Meteor 支 持 Mac OS X 10.7 及 以 后 的 版 本 ， 还 支持 Linux x86 和 x86_64 系 统 。 在 支持 的 系统 上 
安装 Meteor， 只 需要 在 终端 中 键入 一 行 命令 : 


$ curl https://install.meteor.com/ | sh 
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此 代码 将 下 载 并 在 系统 上 安装 整个 Meteor 平 台 , 并 且 使 得 CLI 工 具 全 局 可 用 ( 如 图 A-1 所 示 )。 


AoK 命 stephan | 
Last login: Mon Apr 27 11:38:52 on tty5002 
MacBook:~ stephan$ curl https://install.meteor.com/ | sh 

% Total % Received % Xferd Average Speed Time Time Time Current 

Dload Upload Total Spent Left Speed 

199 6121 8 6121 9 9 6949 8 ~- 一 :一 -~:~-:-- -=:--:-- 6939 
Downloading Meteor distribution 
从 检 认 闪 认 闪闪 和 稚 检 作 从 认 从 从 从 从 从 各 从 从 从 从 从 从 从 从 从 从 从 从 从 将 从 从 从 从 从 开 从 从 从 大 从 从 人 从 和 从 从 逢 从 从 从 从 各 从 符 符 帮 认 闪闪 闪闪 闪 兴 并 闪 寿 检 100 8% 








Meteor 1.1.0.2 has been installed in your home directory (~/.meteor). 
Writing a launcher script to /usr/\local/bin/meteor for your convenience. 


To get started fast: 
$ meteor create ~/my_cool_app 
$ cd ~/my_cool_app 
$ meteor 


Or see the docs at: 


docs.meteor.com 





MacBook:~ stephan$ 目 





图 A-1 在 Mac OS X 上 安装 Meteor 


安装 中 ， 你 不 需要 拥有 管理 员 权 限 ， 但 你 可 能 需要 提供 密码 ， 使 Meteor 能 够 创建 一 个 到 
/usr/local/bin/meteor 的 符号 链接 ， 这 样 你 机 器 上 的 所 有 用 户 都 可 以 使 用 meteor 命 令 。 














提示 ”如果 需要 纯 载 Meteor， 可 以 删除 /usr/local/bin/meteor 文 件 和 home 目 录 下 的 .meteor/ 目 录 。 


A.3 在 Windows 上 安装 Meteor 


下 载 官方 的 Meteor 安 装 文件 : https://install.meteor.com/windows。 简 单 地 双击 InstallMeteor.exe 
文件 将 开始 安装 过 程 (图 A-2 )。 在 这 个 过 程 中 ,你 会 被 要 求 提 供 Meteor 开 发 账号 的 密码 或 创建 一 
个 新 的 账户 。 如 果 你 想 ， 可 以 跳 过 这 一 步 。 











Installing Meteor, the complete open source platform 
for building apps in pure JavaScript. 








ET 


Installing Meteor... please wait, (This may take a minute ortwoJ) 


METESSR 








图 A-2 在 Windows 上 安装 Meteor 


一 日 安装 完成 ， 你 就 可 以 像 在 Linux 或 Mac OS X 系 统 上 那样 使 用 Meteor 的 CLI 工 具 。 
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A.4 ”使 用 Vagrant 运行 Meteor 


如 果 你 想 在 不 支持 的 平台 上 运行 Meteor， 或 想 使 用 和 生产 服务 器 相同 的 操作 系统 进行 测试 ， 
可 以 使 用 虚拟 机 来 增强 你 的 开发 环境 。 一 个 可 能 的 方法 是 使 用 Vagrant, 它 可 以 把 虚拟 机 紧密 集成 
到 主机 系统 中 ， 让 你 以 虚拟 机 的 形式 使 用 可 移植 的 开发 环境 。 这 样 ， 你 就 可 以 轻松 地 交换 文件 ， 
运行 neteor 这 样 的 命令 。 

你 可 以 从 这 里 下 载 Vagrant 的 安装 程序 : https:/www.vagrantup.com。 你 还 需要 安装 Oracle 的 
VirtualBox , 它 可 以 在 这 里 找到 : https://www.virtualbox.org。 此 外 , 你 还 应 该 安装 一 个 SSH 客 户 端 。 
它 可 以 是 PuTTY 或 Cygwin 提 供 的 ssh 命 令 。 

一 旦 完成 安装 ， 可 以 使 用 下 面 的 命令 添加 一 个 Ubuntu Linux 到 你 的 系统 : 

C:\Users\stephan\> vagrant init hashicorp/trusty32 

这 将 在 当前 目录 下 创建 一 个 Vagrantfile 配 置 文件 。 此 文件 是 一 个 Ruby 程 序 ( 其 中 大 多 数 行 是 
被 注释 掉 的 )， 其 中 包含 你 机 器 的 配置 设置 。 除 了 一 些 基 本 的 配置 设置 以 外 ， 它 还 包括 用 于 虚拟 
机 的 镜像 设置 ， 在 这 种 情况 下 ， 它 是 一 个 32 位 的 Ubuntu 14.04 系 统 ( 代号 ; Trusty Tahr )， 这 是 由 
Vagrant 的 作者 HashiCorp 提 供 的 。 




































































提示 即使 你 正在 运行 一 个 64 位 的 操作 系统 ， 你 仍然 可 以 使 用 Vagrant 创 建 一 个 32 位 的 客户 操作 
系统 ( Guest OS )， 但 反之 则 不 行 。 在 某 些 情况 下 ， 使 用 32 位 系统 会 更 有 效 ， 尤 其 是 只 分 
配 少 量 内 存 到 客户 系统 的 时 候 。 


























客户 系统 内 存 的 默认 值 是 512MB, 它 使 用 一 个 CPU 核心 , 对 于 小 的 开发 环境 来 说 这 通常 足够 
了 。 但 如 果 你 需要 增加 内 存 或 核心 数 ， 可 以 调整 Vagrantfile, 在 最 后 的 end 之 前 添加 以 下 内 容 (这 
导致 最 后 两 行 中 都 有 eng ): 


config.vm.provider "virtualbox" do |vl RAM 大 小 (单位 是 MB) 
V.memory = 1024 Ws 
区 GD 三: 党 SEE 、 

区 分 配给 客户 系统 


的 CPU 核心 数 

要 在 Windows 浏 览 需 中 打开 Meteor 应 用 , 你 需要 设置 端口 转发 。 取消 以 config.vm.network 
开始 的 那 一 行 的 注释 ( 删除 # 符 号 )， 调 整 设 置 如 下 : 

config.vm.network "forwarded_ port", guest: 3000, host: 3000 

你 也 可 以 为 虚拟 机 分 配 一 个 JP 地址， 方法 是 在 配置 文件 中 添加 下 面 这 一 行 : 

config.vm.network :private network, ip: "192.168.33.31" 

这 样 ， 你 就 可 以 访问 Vagrant 机 器 ， 就 像 通过 SSH 访 问 其 他 远程 服务 器 一 样 。 

当 Vagrant 虚 拟 机 运行 时 , 会 将 到 本 地 计算 机 ( 主机 ) 上 3000 端 口 的 所 有 请 求 转发 到 虚拟 机 ( 客 
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户 系统 ) 的 3000 端 口 。 一 旦 虚拟 机 中 开启 Meteor， 你 就 可 以 在 浏览 器 中 键入 http://localhost:3000 
访问 该 应 用 。 
要 启动 你 的 虚拟 机 ， 发 出 下 面 的 命令 (最 常见 命令 的 概述 参见 表 A-1 ): 


C:\Users\stephan\> vagrant up 


表 A-1 常见 的 Vagrant 命 令 



































人 措 述 

Ti 初始 化 当前 目录 为 Vagrant 目 录 ， 如 果 Vagrantfile 不 存在 ， 创 建 一 个 初始 的 Vagrantfile。 将 虚拟 机 的 名 
字 作 为 参数 传递 

up 根据 你 的 Vagrantfile 创 建 和 配置 客户 系统 

ssh 使 用 SSH 访 问 运行 的 Vagrant 机 器 ， 让 你 可 以 访问 一 个 shell 

suspend ts a 以 便当 你 恢复 运行 时 ， 它 立即 从 该 点 开始 运行 ， 而 不 是 进行 一 次 完整 
和 局 却 

resume 继续 运行 暂停 的 Vagrant 虚 拟 机 

halt 关闭 Vagrant 管 理 的 正在 运行 的 机 器 

destroy 停止 运行 的 机 器 ， 并 销毁 在 机 器 创建 过 程 中 创建 的 所 有 资源 。 运 行 此 命令 后 ， 你 的 计算 机 将 处 于 一 
个 干净 的 状态 ， 就 好 像 你 从 来 没有 创建 过 一 台 客 户 机 器 























Vagrant 将 从 互联 网 获取 Vagrantfile 中 定义 在 的 镜像 ， 把 它 存储 为 一 个 可 重用 的 镜像 ( 这 将 加 
快 未 来 所 有 vagrant up 命令 的 执行 )。 你 只 需要 在 第 一 次 下 载 镜像 时 连接 到 互联 网 。Vagrant 将 
设置 你 的 虚拟 机 ， 人 允许 你 通过 SSH ( 大 多 数 系统 的 默认 密码 是 vagrant ) 访问 它 : 


C:\Users\stephan\> vagrant ssh 


从 这 里 开始 ， 你 基本 上 是 在 一 个 真正 的 虚拟 化 Linux 系 统 中 。 使 用 Vagrant 的 美妙 之 处 是 文件 
的 即时 共享 ， 所 以 你 可 以 使 用 你 选择 的 Windows 编 辑 器 并 使 用 本 地 浏览 器 。 默 认 情 况 下 ， 用 户 的 
home 目 录 和 虚拟 机 是 共享 的 ， 所 有 存放 在 CNUsersN 中 的 文件 可 以 在 客户 系统 的 /Vagrant 下 访问 。 

你 现在 就 可 以 用 前 面 描述 的 方式 安装 Meteor 了 。 

Vagrant 可 以 把 Meteor 环 境 同系 统 的 其 他 部 分 清楚 地 分 开 。 







































































MongoDB 剂 析 








本 附录 内 容 
口 可 扩展 的 MongoDB 架 构 
口 如 何 设置 MongoDB 的 最 新 操作 日 志 











Meteor 的 设计 目的 是 为 和 MongoDB 一 起 工作 。 如 果 你 考虑 自己 来 管理 数据 库 服务 器 , 首先 应 
该 知道 MongoDB 的 基本 组 成 部 分 、 如 何 缩放 它 以 及 如 何 将 其 与 Meteor 整 合 在 一 起 。 

本 附录 将 向 你 介绍 更 高 级 的 主题 。 这 里 假设 你 对 系统 架构 和 管理 有 一 些 基本 的 了 解 。 学 完 本 
附录 ， 你 将 会 熟悉 有 关 建 立 和 运行 自己 的 MongoDB 实 例 的 最 重要 的 几 个 方面 。 





B.1 MongoDB 组 件 














MongoDB 数 据 库 是 相当 简单 的 。 你 在 一 个 终端 中 访问 它 ， 通 过 用 户 名 和 密码 进行 验证 ， 其 
查询 看 起 来 像 是 JSON 对 象 。 部 署 MongoDB 最 简单 的 方法 是 使 用 单个 实例 ( 参见 图 B-1 )。 


数据 库 

图 B-1 在 Meteor 中 使 用 MongoDB 最 简单 的 方法 

在 生产 环境 中 , 你 希望 确保 数据 库 总 是 可 用 的 , 因此 需要 了 解 其 原理 以 确定 高 可 用 性 的 要 求 。 

虽然 数据 库 本 身 通常 被 作为 单 进 程 引 用 ， 但 实际 上 有 多 个 进程 在 运行 。 在 MongoDB 中 ， 我 们 会 
区 分 以 下 组 件 。 


口 mongod 



















































































口 mongos 





口 mongoc 
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B.1.1 mongod: 数据 库 和 分 片 


mongodq 进 程 是 数据 库 进 程 并 且 负 责 数据 复制 。 在 最 简单 的 设置 中 ， 它 是 运行 MongoDB 唯 一 
需要 的 进程 。 一 旦 数据 库 对 一 个 实例 而 言 变 得 太 大 ， 它 就 需要 放大 。MongoDB 通 过 将 数据 分 散 
在 多 个 服务 器 上 来 实现 这 一 点 ， 这 就 是 所 谓 的 分 片 。 一 个 分 片 通常 只 包含 整个 数据 库 的 一 部 分 ， 
是 所 有 可 用 文档 的 一 个 子 集 。 
设想 你 将 要 在 数据 库 中 存储 全 球 的 通讯 短 。 由 于 有 很 多 的 记录 , 你 将 数据 分 区 并 存储 在 三 个 
服务 器 上 。 名 字 以 A-J 开 头 的 记录 将 被 放置 在 分 片 !1， 以 K-S 开 头 的 放 在 分 片 >、 以 TZ 开头 的 放 在 
分 片 3。 每 个 分 片 大 约 包含 等 量 的 数据 以 均匀 地 平衡 负载 。 


















































B.1.2 mongos: 查询 路 由 


由 于 现在 有 多 个 数据 库 进 程 ， 这 就 需要 路 由 组 件 将 请 求 引导 到 适当 的 mongod 实 例 。Meteor 
应 用 只 有 一 个 数据 库 连 接 ， 它 不 知道 任何 内 部 数据 库 。 在 一 个 分 片 的 集群 中 ,应 用 访问 数据 库 的 
方式 是 通过 一 个 称 为 MongoDB 的 分 片 进程 ， 或 者 简单 地 叫 mongos。 从 应 用 的 角度 来 看 ， 它 的 行 
为 就 像 mongod 进 程 ， 它 负责 将 数据 分 布 到 正确 的 分 片上 。 应 用 并 不 知道 它 是 否 被 重 定向 到 任何 
其 他 的 mongod 实 例 。 

如 果 你 决定 加 入 一 个 新 的 电话 笑 记 录 ， 你 的 应 用 需要 通过 mongos 访 问 数据 库 并 写 入 一 个 新 
的 记录 。 但 mongos 如 何 知道 这 个 请 求 要 重 定向 到 哪里 并 存储 数据 呢 ? 


B.1.3 mongoc: 配置 服务 器 


分 片 集群 需要 一 个 这 样 的 实例 ， 它 知道 哪些 数据 驻 留 在 哪个 分 片 中 。 这 就 出 现 了 mongoc。 
这 个 进程 被 称 为 配置 服务 器 ， 从 技术 上 说 它 是 一 种 特殊 的 mongoG 实 例 。 配 置 服务 器 要 求 在 任何 
时 候 都 可 用 , 这 是 至 关 重 要 的 , 尽管 它们 不 需要 处 理 大 量 的 负载 ， 因 为 路 由 实例 缓存 了 所 有 相关 
的 数据 以 提高 性 能 。 当 路 由 服务 器 启动 时 ， 它 们 与 配置 服务 器 联系 以 获得 集群 元 数据 。 有 时 
MongoDB 数 据 库 会 使 用 平衡 技术 拆 分 或 迁移 数据 到 男 一 个 分 片 ， 这 时 就 会 有 数据 被 写 人 到 配置 
服务 器 。 在 生产 环境 中 ，MongoDB 的 开发 者 推荐 使 用 三 个 mongoc 实 例 。 如 果 你 不 想 使 用 分 片 ， 
就 不 需要 使 用 任何 配置 服务 器 。 

在 电话 短 的 例子 中 ，mongoc 进 程 确保 所 有 以 R 开 头 的 文档 都 存储 在 分 片 2 上 ， 所 以 mongos 
实例 知道 要 将 应 用 的 写 人 请 求 重 定向 到 哪个 机 器 上 。 


B.1.4 副本 集 


设计 高 可 用 性 时 , 你 不 能 承受 丢失 某 个 分 片 的 风险 。 为 了 防止 数据 在 某 个 进程 死亡 时 不 可 用 ， 

你 可 以 使 用 副本 集 (replica set )。 副 本 集 有 三 种 类 型 的 成 员 。 
口 首要 成 员 (了 Primary )。 仅 在 首要 成 员 上 执行 所 有 的 写 操作 。 首 要 成 员 会 维护 操作 日 志 
(oplog )， 这 是 所 有 复制 行为 的 基础 ， 也 被 Meteor 用 作 一 个 比 查 询 比较 方法 更 好 的 选择 。 
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口 备用 成 员 (Secondary )。 备 用 成 员 维护 和 首要 成 员 相 同 的 数据 集 。 如 果 首 要 成 员 不 可 用 ， 
它们 会 取代 首要 成 员 而 成 为 一 个 新 的 首要 成 员 。 故 障 转 移 时 需要 剩余 的 成 员 投票 给 新 的 
首要 成 员 。 

口 仲裁 者 ( Arbiter )。 虽 然 技 术 上 说 它 不 是 一 个 真正 的 副本 集成 员 ， 但 仲裁 者 在 选举 新 的 首 
要 成 员 时 可 以 投票 。 它 不 维护 一 个 副本 ， 也 不 能 成 为 一 个 新 的 首要 成 员 。 仲 裁 者 是 一 种 
特殊 的 mongod 进 程 。 

每 个 副本 集 都 需要 一 个 专用 的 mongod 进 程 。 多 个 进程 可 以 在 同一 个 物理 或 虚拟 机 上 运行 ， 

但 它们 必须 使 用 不 同 的 端口 。 

在 电话 短 的 例子 中 ， 你 有 三 个 mongoq 实 例 在 每 个 分 片上 运行 。 首 要 副本 集 是 可 写 的 ， 根 据 
具体 的 群集 配置 , 所 有 的 其 他 副本 集 都 将 被 用 于 自动 故障 转移 的 备份 , 或 者 用 于 只 读 实例 以 达到 
最 佳 的 负载 平衡 。 

当 一 个 首要 副本 集 不 可 用 时 , 它 可 以 自动 被 备用 成 员 所 取代 。 其 余 的 节点 将 投票 表决 以 确定 
哪个 备份 成 员 将 成 为 新 的 首要 成 员 。 因 为 一 个 成 员 不 能 为 自己 投票 , 所 以 在 一 个 副本 集中 需要 有 
奇数 个 成 员 。 当 你 有 三 个 副本 集 ， 其 中 一 个 不 可 用 时 ， 剩 下 的 两 个 将 选 出 新 的 首要 成 员 。 如 果 不 
管 什 么 原因 你 需要 使 用 偶数 个 副本 集 ， 比 如 两 个 就 足够 了 , 你 不 需要 男 一 个 实例 的 额外 网 络 和 磁 
盘 IO 开销 ， 此 时 你 就 需要 一 个 仲裁 者 的 帮助 来 打破 均衡 。 和 否则 ， 如 果 已 经 有 不 均衡 的 副本 集 ， 
你 可 能 不 需要 一 个 仲裁 者 。 因 此 , 一 个 副本 集 永远 不 会 有 一 个 以 上 的 仲裁 者 与 之 相关 。 仲 裁 者 参 
与 投票 ， 但 它们 不 会 为 机 器 上 的 复制 进程 添加 额外 的 负载 。 在 图 B-2 中 不 需要 一 个 仲裁 者 ， 因 为 
副本 集成 员 (3 ) 已 经 是 不 均衡 的 数量 。 

1. 操作 日 志 

副本 集 并 不 只 局 限于 多 个 分 片 的 部 署 。 即 使 在 单个 分 片 部 署 中 ， 如 当 你 运行 neteor CLI 工 
具 时 ， 副 本 集 也 是 有 用 的 ， 因 为 它们 启用 了 操作 日 志 ,， 这 是 增强 Meteor 应 用 在 多 台 服 务 器 上 运行 
性 能 的 重要 途径 。 

在 电话 每 的 例子 中 ， 管 理 员 可 能 有 一 批 名 字 和 其 他 数据 需要 直接 导入 数据 库 而 不 需要 通过 
Web 应 用 输入 。 此 外 , 应 用 的 两 个 实例 可 以 并 行 运行 ， 这 样 两 个 实例 可 以 同时 改变 数据 。 在 这 两 
种 情况 下 ， 应 用 要 知道 任何 数据 库 的 变化 ， 只 能 通过 一 个 专门 的 请 求 (如 “查找 所 有 条 目 ”)。 
Meteor 的 标准 行为 是 每 10 秒 轮 询 一 次 数据 库 。 

进行 这 样 的 定期 操作 将 给 数据 库 以 及 Meteor 服 务 器 增加 不 必要 的 负载 , 并 带 来 了 明显 的 滞后 
性 ， 这 就 是 为 什么 Meteor 能 够 使 用 一 个 更 聪明 的 方法 : 通过 钩子 直接 进入 复制 流 订 阅 操作 日 志 。 
操作 日 志 是 一 个 特殊 的 集合 ， 其 中 保存 了 修改 数据 库 数据 的 所 有 操作 的 滚动 记录 。 

2. 组 件 分 布 

生产 级 MongoDB 包 含 多 个 物理 或 虚拟 服务 器 。 要 运行 配置 服务 器 ， 至 少 需 要 三 个 服务 器。 
mongogd 的 多 个 实例 也 可 以 运行 在 同一 台 服 务 器 上 ， 虽然 通常 它们 应 该 运行 在 专用 的 机 器 上 。 对 
于 查询 路 由 mongos， 下 面 有 两 个 最 好 的 做 法 ， 你 可 以 选择 其 中 一 个 。 

口 专用 的 路 由 服务 器 ， 至 少 有 两 个 并 且 在 不 同 的 服务 器 上 。 
口 在 每 个 Meteor 服 务 器 上 部 署 一 个 nongos 实 例 。 
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在 专用 的 路 由 服务 器 上 


运行 时 ， 所 有 实例 都 必须 监听 同一 个 地 址 ， 因 为 每 个 Meteor 服 务 器 都 


只 使 用 一 个 专用 的 连接 字符 串 。 因 此 , 应 该 在 nongos 前 面 使 用 负载 均衡 ， 如 HAProxy 或 者 nginx。 


这 样 做 将 引入 另 一 个 单 点 的 失败 "， 这 意味 着 负载 均衡 也 必须 高 度 可 用 。 


查询 路 由 


集群 元 数据 配置 
服务 器 
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分 片 1 
图 B-2 可 用 于 生产 的 MongoDB 设 置 


分 片 2 





分 片 3 


为 了 避免 过 于 复杂 的 场景 ， 你 可 以 简单 地 决定 在 将 要 使 用 的 每 个 Meteor 服 务 器 上 安装 
mongos。 使 用 系统 工具 ， 你 可 以 配置 mongos 进 程 ， 如 果 它 崩溃 了 就 重新 启动 ， 这 使 得 利用 这 种 


方法 管理 起 来 更 简单 。 














中 这 里 的 单 点 失败 指 负 载 均衡 不 可 用 。 一 一 译 者 注 
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B.2 ”设置 MongoDB 


对 部 署 一 个 可 用 于 生产 环境 的 包括 分 片 和 查询 路 由 的 MongoDB 集 群 而 言 ， 虽 然 我 们 不 能 履 
盖 其 中 所 有 的 细节 , 但 这 一 部 分 涵盖 了 在 Meteor 中 进行 部 署 的 细节 。 我 们 将 把 重点 放 在 建立 带 有 
副本 集 的 单个 实例 ， 这 使 你 可 以 利用 最 新 的 操作 日 志 。 关 于 设置 MongoDB 的 进一步 信息 ， 可 以 
参考 官方 文档 或 者 Kyle Banker 的 《MongoDB 实 战 》"。 

1. 建立 最 新 操作 日 志 〈oplog tailing ) 

操作 日 志 存 储 在 系统 数据 库 1ocal 中。 如 果 没 有 定义 任何 副本 集 ， 你 将 不 会 有 一 个 名 为 
oplog .rs 的 集合 (参见 图 B-3 )。 要 初始 化 集合 ， 必 须 定义 一 个 副本 集 ， 但 你 不 需要 添加 多 个 成 
员 ， 可 以 只 使 用 一 个 首要 成 员 。 

每 个 mongod 实 例 都 有 自己 的 配置 "。 首 先 打开 mongodb 配 置 文件 /etc/mongodb.conf。 在 文件 
的 末尾 添加 两 行 : 

replSet=rs0 

oplogSize=100 
第 一 个 参数 定义 了 这 个 mongod 实 例 将 要 使 用 的 副本 集 的 名 称 (replset )。oplogsize 定 义 
了 这 个 集合 可 以 使 用 的 磁盘 空间 ， 此 例 中 为 100MB。 如 果 不 指定 oplogsize， 它 默认 为 空闲 磁 
盘 空 间 的 $%。 

@O@e@ee@ 各: Robomongo 0.8.5 
| 嘿 局 加 国 “ 


了 图 homebrew (1) 
了 MM System 



















































国 homebrew 加 localhost:27017 局 local 


v 县 local pp 
了 Ml Collections (5) | 








有 画 oplogrs 四 0sec. 4 0 | so |b| 国 圆周 | 


> MM Functions 
Pp Users 








图 B-3 ”使 用 Robomongo 访 问 操作 日 志 

















@ 此 书 已 由 人 民 邮 电 出 版 社 出 版 。 一 一 编者 注 
@@ 如 果 在 同一 台 机 器 上 运行 多 个 mongod 进 程 ， 请 确保 你 正在 编辑 正确 的 配置 文件 。 
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下 一 步 ， 重 新 启动 mongod 进 程 ， 打 开 mongo shell。 你 可 以 使 用 Robomongo 这 样 的 工具 或 命 
令 行 。 一 旦 连接 成 功 ， 切 换 到 local 数 据 库 : 

> use local 

下 一 步 是 初始 化 副本 集 ， 启 用 操作 日 志 : 


> rs.initiatel({ 
TO AESO 
members: [{ 
.0 
ostt. TIOGAaLhnoSst 270L7" 
: 
}) 


你 可 以 随时 使 用 rs .status () 检 查 当 前 副本 集 的 状态 ， 使 用 rs .config () 查 看 完整 的 配置 
和 成 员 列 表 。 在 成 功 初 始 化 之 后 , 这 些 命令 应 该 显示 一 个 具有 单个 成 员 的 副本 集 ， 类 似 于 图 B-4。 

正如 你 在 图 B-4 中 看 到 的 , 两 个 额外 的 集合 将 被 创建 : oplog.rs 和 system.replset。 此 外 ， 
shell 提 示 将 改变 以 反映 副本 和 集 名 称 及 其 成 员 身 份 (rs0:PRIMARY )。 

现在 ，MongoDB 在 oplog .rs 集合 中 自动 跟踪 所 有 的 写 操作 。 一 旦 达到 指定 的 大 小 ， 它 将 清 
除 旧 的 记录 。 

2. 设置 一 个 操作 日 志 用 户 

默认 情况 下 ，MongoDB 不 要 求 用 户 进行 身份 验证 。 在 这 样 的 环境 中 ， 你 无 需 凭据 就 能 访问 
操作 日 志 ， 所 以 可 以 跳 过 这 一 步 。 但 在 生产 环境 中 ,你 应 该 添加 用 户 以 提供 一 种 访问 控制 方法 。 
为 了 访问 最 新 的 操作 日 志 , 你 需要 一 个 专门 的 用 户 以 访问 local 数 据 库 , 而 这 就 是 oplog .rs 
集合 保存 的 地 方 。 









































说 明 即使 操作 上 日志 用 户 可 以 访问 local 数 据 库 ,但 从 技术 上 说 ， 它 创建 于 admin 数 据 库 内 部 。 
这 是 因为 local 数 据 库 里 面 不 允许 创建 任何 用 户 。 





用 下 面 的 命令 可 创建 一 个 操作 日 志 用 户 : 


db.createUser ({ 设置 想 要 
user:'oplog', 的 用 户 名 ee 
pwd: 'password', 设置 密码 
roles:[ 


{ role: "read", db: "local" } 


] “| local 数 据 库 的 
3 读 权限 
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rs.status() 
显示 没有 活 
动 的 副本 集 


rs.initiate!() 


使 用 localhost 配 


置 副本 集 NU 


xs.status() 
显示 了 一 个 健 
康 的 副本 集 





命令 行 提示 中 
包含 这 个 服务 
器 副本 集 的 当 
前 名 字 和 状态 





MacBook:~ stephans$ mongo 
MongoDB shell version: 3.8.1 
connecting to: test 

> rs.status() 


{ 
"info" : "run rs.initiate(...) if not yet done for the set", 
“ok” : @, 
"errmsg" : "no replset config has been received", 
"code" : 94 

} 

> rs.initiate({ 

aas _id: "rs@", 

‘0 members: [{ 

nus -id;: §; 

oss host: "localhost:27817" 

“0 

.es }) 





“ak” 2 1 } 
rs@:SECONDARY> rs.status() 


人 
"date" : ISOQDate("2815-84-89T11:15:53.9972"), 
wmyState” : 1, 


"members" : 【 
坟 
“name” : "localhost:27817", 
"health”" : 1, 
wstate* ss 1 
"stateStr" : "PRIMARY", 
suptime” : 141, 
"optime" : Timestamp(1428578148, 1), 
"optimeDate" : ISODate("2015-84-89T11:15:482"), 
"electionTime" : Timestamp(1428578148, 2), 
"electionDate" : ISQDate("2815-84-89T11:15:482Z"), 
"configVersion” : 1, 
"self" : true 

} 
]， 
woks : 1 





图 B-4 在 mongo shell 中 初始 化 一 个 副本 集 








设置 nginx 








本 附录 内 容 

口 设置 nginx 用 于 负载 均衡 
口 使 用 nginx 提 供 静 态 内 容 
口 为 Meteor 应 用 启用 SSL 








虽然 用 于 支撑 Meteor 服 务 的 Nodejs 技 术 非 常 适合 处 理事 件 , 但 它 没有 对 图 像 这 样 的 静态 内 容 
处 理 进 行 优 化 。 虽 然 在 Node.js 应 用 中 使 用 SSL 是 可 能 的 ， 但 在 Meteor 中 还 是 不 可 能 的 。Node.js 是 
单线 程 应 用 , 不 能 利用 多 核 处 理 器 的 所 有 计算 能 力 ,， 这 个 事实 可 能 足以 让 你 认为 Meteor 的 缩放 将 
很 复杂 。 

值得 庆幸 的 是 , 为 Meteor 应 用 构建 一 个 能 够 克服 上 面 所 有 缺点 的 生产 环境 并 不 需要 太 多 的 工 
作 。 在 本 附录 中 , 你 将 学 习 如 何 使 用 轻 量 级 Web 服 务 器 nginx 完 成 运行 一 个 坚 如 磐石 的 Meteor 项 目 
所 需要 的 所 有 工作 。 


C.1 使 用 nginx 实现 负载 均衡 


用 软件 运行 负载 均衡 最 流行 的 选择 是 nginx 和 HAProxy。 这 二 者 都 是 免费 的 开源 软件 , 但 由 
HAProxy 是 一 个 负载 均衡 器 ， 而 nginx 是 一 个 具有 负载 均衡 功能 的 Web 服 务 器 ，HAProxy 将 在 你 需 
要 它们 的 时 候 提供 更 高 级 的 功能 "。 

我 们 的 例子 使 用 nginx 是 因为 它 更 灵活 ， 它 可 以 做 所 有 需要 的 事情 以 确保 Meteor 应 用 始终 可 
用 。 你 可 以 通过 添加 单个 应 用 来 减少 设置 的 复杂 性 ， 以 解决 生产 环境 中 面临 的 挑战。 





























强 沁 




















C.1.1 在 Ubuntu 中 安装 nginx 


在 所 有 主要 的 Linux 发 行 版 中 ，nginx 都 可 以 使 用 包 管 理 髓 安装 。 在 Ubuntu 和 Debian 中 ， 其 命 
今 如 下 : 


S sudo apt-get install nginx 














@ 值得 注意 的 是 ， 商 业 版 本 的 nginx 提 供 了 更 多 高 级 的 功能 ， 但 它 不 是 开源 的 。 关 于 免费 和 付费 版 本 nginx 之 间 的 差 
异 ， 可 以 参考 http://nginx.com/products/feature-matrix/。 
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Meteor 使 用 WebSockets， 而 nginx 在 版 本 1.3 才 开始 支持 WebSockets， 所 以 请 确保 你 使 用 的 是 
最 新 版 本 ( 参见 图 C-1 )。 


全 昌国 人 stephan 一 stephen@bonham: ~ 
| stephen@bonham:~$ sudo apt-get install nginx 
Reading package lists... Done 
Building dependency tree 
Reading state information... Done 
nginx is already the newest version, 
8 upgraded, 0 newly installed, 8 to remove and 0 not upgraded. 
stephen@bonham:~$ nginx -v 
nginx version:; nginx/1.4.6 (Ubuntu) 
stephen@bonham:~$ 














图 C-1 安装 nginx 


C.1.2 在 Debian 7 (Wheezy) 上 安装 nginx 


在 Debian 7 (Wheezy ) 上 ， 默 认 的 nginx 版 本 太 旧 ， 不 支持 WebSockets， 所 以 你 应 该 从 dotdeb 
库 中 安装 它 。 在 /etc/apt/sources.list 文 件 的 最 后 简单 地 添加 以 下 两 行 : 


deb http://packages.dotdeb.org wheezy all 
deb-src http://packages.dotdeb.org wheezy all 


然后 使 用 这 两 个 命令 获取 并 安装 dotdeb GPG 密 钥 : 


$ wget http://www.dotdeb.org/dotdeb.gpg 
$ sudo apt-key add dotdeb.gpg 


一 旦 运行 完 apt -get update， 你 就 可 以 这 样 安装 nginx 最 新 的 稳定 版 本 : 
apt-get install nginx 


接 下 来 ,你 将 配置 nginx 以 监听 meteorinaction.com 站 点 的 请 求 ,定义 运行 Meteor 的 后 端 服务 器 ， 
并 把 请 求 转发 给 它们 。 另 外 ，nginx 不 能 发 送 任何 请 求 到 不 可 用 的 后 端 服务 器 。 





说 明 Debian 8 (Jessie ) 中 带 有 nginx 1.6。 所 以 没有 必要 添加 额外 的 库 ， 你 可 以 使 用 apt-get 
install nginx 安 装 nginx 而 不 需要 前 面 的 准备 步骤 。 


C.2 把 nginx 配置 成 一 个 负载 均衡 器 


类 似 于 Apache，nginx 使 用 通用 的 服务 器 配置 文件 ， 理 想 情况 下 每 个 虚拟 主机 应 在 一 个 单独 
的 文件 中 配置 。 你 不 必修 改 通 用 的 主 配置 文件 , 只 需 为 你 的 Meteor 应 用 创建 一 个 额外 的 配置 文件 。 


C.2.1 创建 一 个 站 点 配置 文件 
首先 , 在 /etcmmginx/sites-available 目 录 创 建 命 名 为 meteorinaction.com 的 新 文件 。 要 监听 所 有 的 
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请 求 ， 你 需要 定义 服务 器 的 名 称 和 nginx 应 该 监听 的 端口 。 
此 外 , 你 要 把 所 有 请 求 重 定向 到 有 www 前 级 的 请 求 "。 相 应 的 文件 显示 在 以 下 代码 清单 中 。 




















代码 清单 C-1 nginx 网 站 配置 


只 0 斤 半 
server { EE 仅 在 请 求 meteorinaction.com 时 
listen 80; < 一 应 用 此 配置 
SerVer_name meteorinaction.com; < 
return 301 http://ww.meteorinaction.com$srequest uri,; < 人 一 
中 
重 定向 请 求 到 www 的 子 域 ， 
保留 URI 字 符 串 ， 并 使 用 301 
server { HTTP 状 态 
listen 80; 
server_name www.meteorinaction.com; < 一 


对 www.meteorinaction.com 


和 所 有 其 他 请 求 使 用 此 配置 





C.2.2 定义 Meteor 服务 器 


要 让 nginx 知 道 把 请 求 转发 到 哪个 服务 器 ,需要 使 用 upstream 模 块 。 因 为 任何 服务 器 配置 都 
可 以 使 用 任何 upstream 组 ， 所 以 它 不 能 在 server {} 块 中 。 在 配置 文件 的 开头 ， 添 加 下 面 的 块 : 











为 你 的 upstream 组 选择 
一 个 唯一 的 名 称 
< 


upstream meteor_servers { 


server 192.168.2.221:3000; 二 一 短 行 对 应 一 个 Meteor 
server 192.168.2.222:3000; 站 
服务 器 实例 
ip_hash; RO 
} 指定 如 何 
分 发 请 求 


你 可 以 认为 upstream 是 一 组 服务 器 。 每 个 以 server 开 始 的 行 定 义 了 一 个 新 的 实例 。 第 一 个 
参数 是 服务 器 的 实际 地 址 。 运 行 nginx 的 机 器 必须 能 够 访问 它 ， 但 不 要 求 可 以 从 互联 网 访问 
upstream 服 务 器 。 因 此 ， 你 也 可 以 使 用 本 地 的 Meteor 实 例 127.0.0.1 作 为 upstream。 在 这 个 例子 中 ， 
这 两 个 实例 都 只 能 从 192.168.2.0/24 范 围 内 的 私有 网 络 进 行 访问 。 

现在 , 所 有 传 入 的 请 求 都 将 被 平等 地 分 配 到 两 个 后 端 服 务 器 。 你 可 以 进一步 指定 参数 ， 如 权 
重 , 以 微调 环境 设置 。 在 所 有 的 请 求 中 ,你 需要 记 住 的 是 , 它们 是 有 状态 的 ,在 服务 器 之 间 移 动 
请 求 可 能 会 破坏 用 户 的 会 话 。 为 确保 一 个 用 户 的 多 个 请 求 不 会 在 服务 器 之 间 来 回 移动 , 最 简单 的 
方法 是 使 用 ip_hash 指 令 。 将 它 添加 到 你 的 配置 块 , 告诉 nginx 总 是 把 来 自 同一 IP 的 请 求 重 定 问 到 
相同 的 上 游 (upstream ) 服务 器 。 



























































@ 虽然 对 用 户 而 言 ， 在 一 个 地 址 中 丢掉 www 是 很 方便 的 ,但 任何 运行 在 “ 裸 ” 顶 级 域名 上 的 网 站 会 带 来 可 扩展 性 问 
题 。 如 果 不 使 用 子 域名 ，DNS 系 统 将 会 锁定 你 的 域名 ， 只 为 它 分 配 一 个 下地 址 ， 这 就 是 我 们 要 把 所 有 流量 重 定向 
到 子 域名 的 原因 。 用 户 没有 它 仍然 可 以 访问 你 的 网 站 ， 但 它们 会 自动 被 重 定向 。 更 多 内 容 可 参考 http:/www.yes- 


WwWw.Org/why-use-www/。 
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说 明 如 果 你 期 望 有 许多 请 求 来 自 同一 IP, 使 用 ip_hash 指 令 可 能 会 导致 服务 器 上 的 用 户 分 布 不 
均匀 。 在 这 种 情况 下 ， 你 应 该 在 nginx 配 置 中 包含 sticky 模 块 并 使 用 least_conn 指 令 来 替 
代 ip_hash。 更 多 相关 内 容 可 以 参考 https://bitbucket.org/nginx-goodies/nginx-sticky- 
module-ng/overview。 另 外 ，HAProxy 可 能 是 更 好 的 解决 方案 。 


C.2.3 ”将 请 求 转发 到 后 端 服务 器 


一 旦 nginx 监听 请 求 并 知道 了 上 游 服务 器 ， 你 就 可 以 定义 转发 请 求 的 方式 。 在 
www.meteorinaction.com 的 配置 块 中 ， 你 为 根 ( / ) 添加 了 一 个 新 的 位 置 ( 见 下 面 的 代码 清单 )。 


代码 清单 C-2 ”在 nginx 中 ， 请求 转 发 的 位 置 


server { 











js /{ 
proxy_pass http://meteor_server; 
proxy_redirect off; 
proxy_http_version 1.1; 
proxy_set_header X-Forwarded-For Sproxy_add x_ forwarded_ for; 
proxy_set_header Host S$http_host; 
proxy_set_header Upgrade s$http_upgrade; 
proxy_set_header Connection "upgrade"; 
} 
} 
让 我 们 逐 行 来 看 这 个 配置 。 
口 broxy_pass 用 来 告诉 nginx 应 把 请 求 转发 到 这 个 位 置 。 它 使 用 了 上 游 组 (upstream group ) 
的 名 称 ( meteor_server )， 它 并 不 是 一 个 真正 的 URL。 
D proxy_redirect 可 以 用 来 在 更 复杂 的 情况 下 重 写 URL 请 求 。 在 你 的 设置 中 不 需要 它 ， 
所 以 把 它 关 掉 。 
口 proxy_http_version 设 置 HTTP 的 版 本 为 1.1( 默认 是 1.0 ), 这 是 WebSockets 功 能 必需 的 。 
口 proxy_set_header 允许 你 添加 或 修改 发 送 到 Meteor 服 务 器 的 一 些 请 求 头 。 
X-Forwardqedq-For 包 含 了 发 出 请 求 用 户 的 卫 地 址 。 尤 其 是 当 nginx 是 和 Meteor 服 务 器 在 同 
一 主机 时 ， 你 需要 这 个 设置 。Host 把 实际 请 求 的 主机 名 传递 给 Meteor 服 务 器 。Upgrade 
和 connection 都 用 于 允许 转发 WebSocket 连 接 。 



















































































C.2.4 激活 nginx 网 站 
配置 负载 均衡 的 最 后 一 步 是 激活 网 站 。 首 先 要 创建 配置 的 符号 链接 ， 该 配置 放 在 /etc/nginx/ 


sites-enabled/meteorinaction.com 目录 : 





























$ sudo ln -s /etc/nginx/sites-available/meteorinaction.com 
/etc/nginx/sites-enabled/meteorinaction.com 
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接 下 来 通过 -t 参 数 调用 nginx， 测 试 该 配置 是 否 正 常 工作 : 
$ sudo nginx -t 
如 果 没 有 错误 ， 你 可 以 重新 加 载 配 置 ， 无 需 重新 启动 nginx: 


$ sudo nginx -s reload 


C.3 用 nginx 提供 静态 内 容 


即使 你 只 期 望 少量 的 用 户 , 使 用 内 容 分 发 网 络 或 反 向 代理 服务 来 提供 静态 文件 也 可 以 大 大 减 
少 用 户 的 等 待 时 间 。 如 果 你 的 应 用 已 经 使 用 nginx 做 负载 均衡 ， 只 需要 几 行 配置 就 可 以 使 它 成 为 
一 个 反 向 代理 。 

Meteor 不 应 该 提供 任何 静态 文件 服务 , 所 以 你 将 会 配置 nginx, 让 它 处 理 所 有 媒体 文件 、 图 像 、 
CSS 以 及 JavaScript 文 件 的 请 求 。 另 外 你 会 启用 gzip 压 缩 。 





























C.3.1 提供 CSS 和 JavaScript 服务 


meteor build 命令 自动 缩小 并 编译 所 有 的 CSS 和 JavaScript 文 件 ， 然 后 把 它们 放 入 文件 夹 
bundle/programs/web.browser。 如 果 要 用 nginx 提 供 这 些 文件 ， 它 们 必须 可 以 从 nginx 服 务 器 访问 。 
如 果 Meteor 被 部 署 到 不 同 的 服务 器 ,你 可 以 将 文件 复制 到 nginx 机 器 或 使 用 网 络 文件 系统 ( Network 
File System，NFS ) 配置 一 个 共享 文件 夹 。 请 记 住 ， 如 果 要 复制 文件 ， 就 需要 在 每 次 部 署 应 用 时 
重复 这 个 动作 。 因 为 每 个 build 命令 都 将 会 创建 新 的 随机 文件 名 ， 所 以 你 不 需要 删除 旧 的 文件 。 
这 将 使 部 署 之 间 可 以 平滑 过 渡 。 

要 配置 静态 的 应 用 文件 和 样式 文件 服务 ， 你 必须 在 nginx 配 置 文件 定义 一 个 新 的 位 置 块 : 









































这 将 抓 取 所 有 文件 名 为 
Server { 40 个 字符 长 并 以 js 或 css 
村 结尾 的 文件 请 求 
Lkocatiom ce* AFLa=2Z0= 9.40 (CSH 夺 i 球 < 一 
root /home/meteor/app/bundle/programs/web.browser/app; 不 要 在 日 志 中 包含 这 些 
这 些 文件 access_log off; < 二 | 文件 以 减少 磁盘 I/O 
可 以 在 这 expires 30d:; < 了 Oe 
个 目录 中 adqd_ header Pragma public; 法 三 一 4 客户 端 可 以 缓存 这 些 
找到 add_header Cache-Control "public"; < 二 一 文件 30 天 
} 
添加 一 个 头 ,将 Cache- 。 ”| 添加 一 个 头 ,设置 
Control 设 置 为 public Pragma 为 public 





在 打包 的 过 程 中 , 所 有 的 CSS 和 JavaScript 文 件 都 会 有 一 个 新 生成 的 由 40 个 字符 (字母 和 数字 ) 
组 成 的 唯一 名 字 ， 只 有 它们 将 被 代理 "提供 给 用 户 。 调 整 oot 目录 的 值 ， 使 nginx 可 以 找到 这 些 
文件 。 这 些 静 态 文 件 将 不 会 进入 日 志 记 录 , 并 且 客 户 端 可 以 缓存 这 些 文件 30 天 (expires 以 及 添 















































@) 也 就 是 前 面 配置 的 nginx 服 务 器 。 一 一 译 者 注 
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加 的 Pragma 和 Cache-Control 头 负责 控制 这 个 )。 接 下 来 的 打包 过 程 将 生成 新 的 文件 名 ， 所 以 即使 
你 在 30 天 的 缓存 过 期 之 前 部 署 应 用 的 新 版 本 ， 也 不 会 遇 到 客户 有 过 时 的 缓存 文件 问题 。 

















说 明 nginx 必 须 能 够 直接 访问 Meteor 创 建 的 文件 ， 以 便 能 以 代理 形式 提供 它们 。 如 果 nginx 不 能 
在 本 地 访问 这 些 文件 ， 你 需要 忽略 这 个 配置 块 。 


C.3.2 ”提供 媒体 文件 和 图 像 服务 


public 文 件 夹 的 内 容 也 应 该 由 nginx 提 供 。 因 为 public 文 件 夹 可 在 应 用 的 根 目 录 下 访问 ， 所 以 
你 将 使 用 文件 扩展 名 确定 一 个 请 求 是 被 静态 服务 还 是 需要 由 Meteor 来 服务 。 该 配置 类 似 于 你 前 面 
看 到 的 块 : 
location ~ \.(jpgljpeglpnglgif|lmp3|icolpdf) { 

root /home/meteor/app/bundle/programs/web.browser/app; 

access_log off; 

expires 30d; 

adqd_header Pragma public; 


adqd_header Cache-Control "public"; 
} 


你 可 以 在 位 置 (location ) 行 的 正则 表达 式 中 添加 所 有 文件 扩展 名 。 打 包 的 过 程 中 ，public 文 
件 夹 的 所 有 内 容 进 入 bundle/programs/web.browser/app 目 录 , 所 以 你 必须 用 这 个 作为 位 置 的 根 路 径 。 

再 次 , 如 果 nginx 不 能 在 本 地 访问 这 些 文件 , 你 应 该 手动 复制 它们 或 使 用 NFS 导 出 这 样 的 共享 
存储 ， 否 则 请 忽略 这 个 配置 。 






































C.3.3 启用 gzip 压缩 


从 nginx 反 向 代理 上 提供 静态 文件 的 最 后 优化 是 启用 gzip 压 缩 。 文本 文件 即使 缩小 了 , 也 可 以 
有 效 地 压缩 ; 特别 地 ， 低 带宽 的 用 户 〈 如 移动 用 户 ) 将 大 大 受益 于 压缩 的 使 用 。 该 配置 不 是 在 任 
何 位 置 块 内 ， 而 是 在 服务 器 块 中 完成 的 : 


servert 


























gzip on; 

gzip_disable "msie6"; 

gzZip_vary on; 

gzZip_proxied any; 

gzip_comp_level 6; 

gzip_types text/plain text/css application/json application/x-JavaScript text/xml 
application/xml application/xml+rss text/JavaScript; 


} 


第 一 行 激 活 gzip 压 缩 ， 第 二 行 在 IE6 中 禁用 它 。 启 用 vary 和 proxied 可 确保 即使 是 可 能 使 用 
代理 服务 器 的 请 求 ， 也 可 以 被 正确 地 处 理 。 在 这 个 示例 中 ， 你 将 压缩 级 别 设置 为 6 ( 范围 为 从 1 
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到 9 )。 最 后 ， 你 确定 要 压缩 的 MIME 类 型 。 


C.4 使 用 nginx 设置 SSL 





因为 Meteor 不 支持 SSL， 所 以 你 需要 配置 nginx 的 SSL 御 载 ， 这 意味 着 SSL 连 接 将 在 负载 均衡 








代理 服务 器 终止 。 不 管 你 使 用 自 签名 证 书 ， 或 由 Thawte 、StartSSL 签 发 的 证 书 ， 还 是 由 任何 其 他 
的 证 书 颁发 机 构 ( CA ) 签发 的 证 书 都 没有 关系 。 你 必须 复制 证 书 文件 ( 扩展 名 为 .crt ) 和 密 钥 文 




















件 (扩展 名 为 .key ) 到 nginx 服 务 器 。 








你 的 Meteor 应 用 和 服务 器 将 像 以 前 一 样 运行 ， 不 需要 任何 改变 。 需 要 做 的 仅仅 是 修改 nginx 























的 网 站 配置 文件 。 
在 服务 器 配置 块 你 把 端口 切换 为 443， 打 开 SSL， 并 配置 将 要 使 用 的 证 书 文件 ( 见 下 面 的 代 
码 清 单 )。 
代码 清单 C-3 nginx 的 SSL 设 置 
监听 默认 的 
ST Vor SSL 端 口 443 
listen 443; 启用 SSL 
server_name www.meteorinaction.com; 
ssl on; 
ssl_certificate /path/to/my.crt; 人 
ssl_certificate key /path/to/my.key; J 位 
ssl_verify_depth 3; 密 钥 文件 
2 当 使 用 级 联 证 书 时 ， 由 
} 必须 调整 深度 





就 像 在 非 SSL 配 置 中 那样 ， 你 必须 定义 端口 和 服务 融 名 称 。 当 ss1 设 置 为 cn 时 ， 你 还 必须 提 


供 一 个 证 书 和 一 个 密 钥 文件 。 有 时 ，CA 发 布 的 指令 要 求 你 将 多 个 文件 合并 成 一 个 。 为 了 


让 nginx 








接受 和 验证 这 种 合并 的 文件 , 你 应 该 调整 ss1_verify_qepth 人 参数。 此 参数 定义 了 中 间 廊 














FE 书 发 行 





人 的 最 大 数量 ， 即 在 验证 客户 端 证 书 时 ,可 以 查 到 多 少 个 证 书 的 深度 。 当 你 将 自己 的 证 书 与 一 个 





初级 和 中 级 证 书 相 结合 时 ， 深 度 应 该 是 3， 自 签名 证 书 的 深度 为 0。 
此 外 ， 你 应 该 添加 一 个 服务 器 ， 监 听 端 口 80， 将 所 有 非 SSL 流 量 转发 到 SSL 端 口 : 





添加 包含 和 不 包含 
server { i 
listen 80; 
server _ name meteorinaction.com www.meteorinaction.com; 
return 301 https://ww.meteorinaction.com$srequest _ uri; 
所 有 的 请 求 被 转发 
到 包含 www 的 


现在 ， 你 的 配置 文件 应 该 有 两 个 服务 需 模 块 : 一 个 监听 端口 443 ， 必 一 个 监听 端口 80 并 转发 














所 有 的 请 求 到 SSL 服 务 器 。 测 试 并 重新 加 载 配置 ， 现 在 所 有 的 配置 就 都 已 经 完成 了 。 
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说 明 这 个 SSL 配 置 是 非常 有 限 的 ,存在 一 些 使 连接 更 安全 的 方式 。 请 查看 本 书 的 随 书 代码 ， 其 
中 有 一 个 完整 的 例子 ， 其 提供 了 最 大 的 安全 性 ， 而 且 同 时 与 大 多 数 浏览 器 兼容 。 
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